Items - Update Semantic Model
Met à jour les propriétés du modèle sémantique spécifié.
Autorisations
L’appelant doit disposer d’autorisations de lecture et d’écriture pour le modèle sémantique.
Étendues déléguées requises
SemanticModel.ReadWrite.All ou Item.ReadWrite.All
Identités prises en charge par Microsoft Entra
Cette API prend en charge les identités Microsoft répertoriées dans cette section.
| Identité | Soutien |
|---|---|
| Utilisateur | Oui |
| principal de service et identités managées | Oui |
Interface
PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels/{semanticModelId}Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
semantic
|
path | True |
string (uuid) |
ID de modèle sémantique. |
|
workspace
|
path | True |
string (uuid) |
ID de l’espace de travail. |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| description |
string |
Description du modèle sémantique. La longueur maximale est de 256 caractères. |
| displayName |
string |
Nom d’affichage du modèle sémantique. Le nom complet doit suivre les règles d’affectation de noms en fonction du type d’élément. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
La demande s’est terminée avec succès. |
|
| Other Status Codes |
Codes d’erreur courants :
|
Exemples
Update a semantic model example
Exemple de requête
PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff255/semanticModels/5b218778-e7a5-4d73-8187-f10824047751
{
"displayName": "Semantic models's New name",
"description": "A new description for semantic model."
}
Exemple de réponse
{
"displayName": "Semantic models's New name",
"description": "A new description for semantic model.",
"type": "SemanticModel",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff255",
"id": "5b218778-e7a5-4d73-8187-f10824047751"
}Définitions
| Nom | Description |
|---|---|
|
Error |
Objet de détails de ressource associé à l’erreur. |
|
Error |
Réponse d’erreur. |
|
Error |
Détails de la réponse d’erreur. |
|
Item |
Représente une balise appliquée à un élément. |
|
Item |
Type de l’élément. Des types d’éléments supplémentaires peuvent être ajoutés au fil du temps. |
|
Semantic |
Objet de modèle sémantique. |
|
Update |
Mettre à jour la demande de modèle sémantique. |
ErrorRelatedResource
Objet de détails de ressource associé à l’erreur.
| Nom | Type | Description |
|---|---|---|
| resourceId |
string |
ID de ressource impliqué dans l’erreur. |
| resourceType |
string |
Type de la ressource impliquée dans l’erreur. |
ErrorResponse
Réponse d’erreur.
| Nom | Type | Description |
|---|---|---|
| errorCode |
string |
Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs. |
| message |
string |
Représentation lisible humaine de l’erreur. |
| moreDetails |
Liste des détails d’erreur supplémentaires. |
|
| relatedResource |
Détails de la ressource associée à l’erreur. |
|
| requestId |
string |
ID de la demande associée à l’erreur. |
ErrorResponseDetails
Détails de la réponse d’erreur.
| Nom | Type | Description |
|---|---|---|
| errorCode |
string |
Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs. |
| message |
string |
Représentation lisible humaine de l’erreur. |
| relatedResource |
Détails de la ressource associée à l’erreur. |
ItemTag
Représente une balise appliquée à un élément.
| Nom | Type | Description |
|---|---|---|
| displayName |
string |
Nom de la balise. |
| id |
string (uuid) |
ID de balise. |
ItemType
Type de l’élément. Des types d’éléments supplémentaires peuvent être ajoutés au fil du temps.
| Valeur | Description |
|---|---|
| Dashboard |
Tableau de bord PowerBI. |
| Report |
Rapport PowerBI. |
| SemanticModel |
Modèle sémantique PowerBI. |
| PaginatedReport |
Rapport paginé PowerBI. |
| Datamart |
Datamart PowerBI. |
| Lakehouse |
Un lac. |
| Eventhouse |
Un eventhouse. |
| Environment |
Environnement. |
| KQLDatabase |
Base de données KQL. |
| KQLQueryset |
Ensemble de requêtes KQL. |
| KQLDashboard |
Tableau de bord KQL. |
| DataPipeline |
Un pipeline de données. |
| Notebook |
Un bloc-notes. |
| SparkJobDefinition |
Définition d’un travail Spark. |
| MLExperiment |
Une expérience de Machine Learning. |
| MLModel |
Modèle Machine Learning. |
| Warehouse |
Un entrepôt. |
| Eventstream |
Flux d’événements. |
| SQLEndpoint |
Point de terminaison SQL. |
| MirroredWarehouse |
Un entrepôt mis en miroir. |
| MirroredDatabase |
Une base de données mise en miroir. |
| Reflex |
Un réflexe. |
| GraphQLApi |
API pour l’élément GraphQL. |
| MountedDataFactory |
Un MountedDataFactory. |
| SQLDatabase |
A SQLDatabase. |
| CopyJob |
Tâche de copie. |
| VariableLibrary |
A VariableLibrary. |
| Dataflow |
Flux de données. |
| ApacheAirflowJob |
An ApacheAirflowJob. |
| WarehouseSnapshot |
Capture instantanée de l’entrepôt. |
| DigitalTwinBuilder |
A DigitalTwinBuilder. |
| DigitalTwinBuilderFlow |
Flux de générateur de jumeaux numériques. |
| MirroredAzureDatabricksCatalog |
Catalogue Azure databricks mis en miroir. |
| Map |
Carte. |
| AnomalyDetector |
Détecteur d’anomalies. |
| UserDataFunction |
Fonction de données utilisateur. |
| GraphModel |
A GraphModel. |
| GraphQuerySet |
Ensemble de requêtes Graph. |
| SnowflakeDatabase |
Une base de données Snowflake pour stocker les tables Iceberg créées à partir du compte Snowflake. |
| OperationsAgent |
A OperationsAgent. |
| CosmosDBDatabase |
Base de données Cosmos DB. |
| Ontology |
Une ontologie. |
| EventSchemaSet |
An EventSchemaSet. |
SemanticModel
Objet de modèle sémantique.
| Nom | Type | Description |
|---|---|---|
| description |
string |
Description de l’élément. |
| displayName |
string |
Nom complet de l’élément. |
| folderId |
string (uuid) |
ID du dossier. |
| id |
string (uuid) |
ID d’élément. |
| tags |
Item |
Liste des balises appliquées. |
| type |
Type d’élément. |
|
| workspaceId |
string (uuid) |
ID de l’espace de travail. |
UpdateSemanticModelRequest
Mettre à jour la demande de modèle sémantique.
| Nom | Type | Description |
|---|---|---|
| description |
string |
Description du modèle sémantique. La longueur maximale est de 256 caractères. |
| displayName |
string |
Nom d’affichage du modèle sémantique. Le nom complet doit suivre les règles d’affectation de noms en fonction du type d’élément. |