Items - Create Semantic Model
Hiermee maakt u een semantisch model in de opgegeven werkruimte.
Deze API ondersteunt langlopende bewerkingen (LRO).
De API ondersteunt drie aanmaakmodi: (1) bieden volledige definition controle over de modelstructuur( 2) bieden een creationPayload OneLake-tabel-URL's om een DirectLake-model te maken, of (3) laten beide weg om een leeg semantisch model te maken. Gebruik definition of creationPayload. U kunt beide niet tegelijk gebruiken.
Machtigingen
De aanroeper moet een werkruimterol inzender hebben. Wanneer u een DirectLake-model maakt met een creationPayload model dat verwijst naar OneLake-tabellen, moet de aanroeper ook toegang hebben tot elk bron lakehouse of gegevensitem waarnaar wordt verwezen, ook wanneer deze bronnen zich in een andere werkruimte bevinden (bronnen voor meerdere werkruimten).
Vereiste gedelegeerde bereiken
SemanticModel.ReadWrite.All of Item.ReadWrite.All
Beperkingen
- Als u een semantisch model wilt maken, moet de gebruiker over de juiste licentie beschikken. Zie voor meer informatie: Microsoft Fabric licentietypen.
Microsoft Entra ondersteunde identiteiten
Deze API ondersteunt de Microsoft identities die in deze sectie worden vermeld.
| Identiteit | Steunen |
|---|---|
| Gebruiker | Ja |
| Service-principal en beheerde identiteiten | Ja |
gebruikersinterface
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels
URI-parameters
| Naam | In | Vereist | Type | Description |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
De werkruimte-id. |
Aanvraagbody
| Naam | Vereist | Type | Description |
|---|---|---|---|
| displayName | True |
string |
De weergavenaam van het semantische model. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype. |
| creationPayload |
De nettolading voor het maken van een semantisch model zonder een volledige definitie. Geef URL's voor OneLake-tabellen op om een DirectLake-model te maken of laat beide |
||
| definition |
De openbare definitie van het semantische model. Gebruik |
||
| description |
string |
De beschrijving van het semantische model. De maximale lengte is 256 tekens. |
|
| folderId |
string (uuid) |
De map-id. Als dit niet is opgegeven of null, wordt het semantische model gemaakt met de werkruimte als map. |
|
| sensitivityLabelSettings |
De instellingen voor vertrouwelijkheidslabels voor het semantische model. |
Antwoorden
| Naam | Type | Description |
|---|---|---|
| 201 Created |
Gemaakt |
|
| 202 Accepted |
Aanvraag geaccepteerd, semantisch model inrichten wordt uitgevoerd. Kopteksten
|
|
| 429 Too Many Requests |
De servicesnelheidslimiet is overschreden. De server retourneert een Kopteksten Retry-After: integer |
|
| Other Status Codes |
Veelvoorkomende foutcodes:
|
Voorbeelden
| Create a semantic model example |
|
Create a semantic model with One |
| Create an empty semantic model example |
Create a semantic model example
Voorbeeldaanvraag
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/semanticModels
{
"displayName": "SemanticModel 1",
"description": "A semantic model description.",
"definition": {
"parts": [
{
"path": "model.bim",
"payload": "ew0KICAiY29tcGF0a..GVzIjogWyBdDQogIH0NCn0=",
"payloadType": "InlineBase64"
},
{
"path": "definition.pbism",
"payload": "ewogICJ2ZXJzaW9uI..NldHRpbmdzIjoge30KfQ==",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
"payloadType": "InlineBase64"
}
]
}
}
Voorbeeldrespons
{
"displayName": "SemanticModel 1",
"description": "A semantic model description.",
"type": "SemanticModel",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715",
"sensitivityLabel": {
"id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
}
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30
Create a semantic model with OneLake tables example
Voorbeeldaanvraag
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/semanticModels
{
"displayName": "Sales Analytics Model",
"description": "A semantic model connected to lakehouse tables.",
"creationPayload": {
"oneLakeTables": [
"https://onelake.dfs.fabric.microsoft.com/aaaa0000-bb11-2222-33cc-444444dddddd/cccc0000-dd11-2222-33ee-444444ffffff/Tables/dim_customer",
"https://onelake.dfs.fabric.microsoft.com/aaaa0000-bb11-2222-33cc-444444dddddd/cccc0000-dd11-2222-33ee-444444ffffff/Tables/sales/dim_product",
"https://onelake.dfs.fabric.microsoft.com/1111aaaa-bb22-3333-44cc-555555eeeeee/2222bbbb-cc33-4444-55dd-666666ffffff/Tables/dim_region"
]
}
}
Voorbeeldrespons
{
"displayName": "Sales Analytics Model",
"description": "A semantic model connected to lakehouse tables.",
"type": "SemanticModel",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30
Create an empty semantic model example
Voorbeeldaanvraag
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/semanticModels
{
"displayName": "SemanticModel 1",
"description": "An empty semantic model."
}
Voorbeeldrespons
{
"displayName": "SemanticModel 1",
"description": "An empty semantic model.",
"type": "SemanticModel",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30
Definities
| Naam | Description |
|---|---|
|
Create |
Maak de nettolading van semantische modelaanvragen. |
|
Entire |
Vertegenwoordigt een tenant-principal |
|
Error |
Een gestructureerde parameter die extra machineleesbare context biedt over een fout. |
|
Error |
Het foutgerelateerde resourcedetailsobject. |
|
Error |
Het foutbericht. |
|
Error |
De details van het foutbericht. |
|
Group |
Groepsspecifieke details. Van toepassing wanneer het principal-type is |
|
Group |
Vertegenwoordigt een beveiligingsgroep. |
|
Group |
Het type groep. Er kunnen in de loop van de tijd extra groepstypen worden toegevoegd. |
|
Item |
Vertegenwoordigt een tag die is toegepast op een item. |
|
Item |
Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd. |
|
Payload |
Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd. |
|
Principal |
Het type principal. Er kunnen in de loop van de tijd extra principal-typen worden toegevoegd. |
|
Semantic |
Een semantisch modelobject. |
|
Semantic |
Nettolading maken voor het maken van een semantisch model zonder definitie. |
|
Semantic |
openbare Semantische modeldefinitie object. Raadpleeg dit artikel voor meer informatie over de structuur van de Semantische modeldefinitie. |
|
Semantic |
Semantisch modeldefinitieonderdeelobject. |
|
Sensitivity |
Vertegenwoordigt een vertrouwelijkheidslabel dat is toegepast op een item. |
|
Sensitivity |
De strategie voor het toepassen van het gevoeligheidslabel. De standaardwaarde is ApplyOrFail. Er kunnen in de loop van de tijd extra typen worden toegevoegd. |
|
Sensitivity |
De instellingen voor vertrouwelijkheidslabels. |
|
Service |
Specifieke details van de service-principal. Van toepassing wanneer het principal-type is |
|
Service |
Vertegenwoordigt een Microsoft Entra service-principal. |
|
Service |
Details van service-principalprofiel. Van toepassing wanneer het principal-type is |
|
Service |
Vertegenwoordigt een service-principalprofiel. |
|
User |
Specifieke details van gebruikersprincipaal. Van toepassing wanneer het principal-type is |
|
User |
Vertegenwoordigt een Microsoft Entra gebruikersprincipaal. |
CreateSemanticModelRequest
Maak de nettolading van semantische modelaanvragen.
| Naam | Type | Description |
|---|---|---|
| creationPayload |
De nettolading voor het maken van een semantisch model zonder een volledige definitie. Geef URL's voor OneLake-tabellen op om een DirectLake-model te maken of laat beide |
|
| definition |
De openbare definitie van het semantische model. Gebruik |
|
| description |
string |
De beschrijving van het semantische model. De maximale lengte is 256 tekens. |
| displayName |
string |
De weergavenaam van het semantische model. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype. |
| folderId |
string (uuid) |
De map-id. Als dit niet is opgegeven of null, wordt het semantische model gemaakt met de werkruimte als map. |
| sensitivityLabelSettings |
De instellingen voor vertrouwelijkheidslabels voor het semantische model. |
EntireTenantPrincipal
Vertegenwoordigt een tenant-principal
| Naam | Type | Description |
|---|---|---|
| displayName |
string |
De weergavenaam van de principal. |
| id |
string (uuid) |
De id van de principal. |
| type |
string:
Entire |
Het type principal. Er kunnen in de loop van de tijd extra principal-typen worden toegevoegd. |
ErrorParameter
Een gestructureerde parameter die extra machineleesbare context biedt over een fout.
| Naam | Type | Description |
|---|---|---|
| message |
string |
Een door mensen leesbare beschrijving van de betekenis van de parameter. |
| name |
string |
De parameter-id. |
| value |
string |
De waarde van de parameter. |
ErrorRelatedResource
Het foutgerelateerde resourcedetailsobject.
| Naam | Type | Description |
|---|---|---|
| resourceId |
string |
De resource-id die betrokken is bij de fout. |
| resourceType |
string |
Het type resource dat betrokken is bij de fout. |
ErrorResponse
Het foutbericht.
| Naam | Type | Description |
|---|---|---|
| errorCode |
string |
Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is. |
| isRetriable |
boolean |
Wanneer waar, kan de aanvraag opnieuw worden geprobeerd. Gebruik de |
| message |
string |
Een leesbare weergave van de fout. |
| moreDetails |
Lijst met aanvullende foutdetails. |
|
| parameters |
Gestructureerde parameters die extra machineleesbare context bieden over de fout. |
|
| relatedResource |
De foutgerelateerde resourcedetails. |
|
| requestId |
string (uuid) |
Id van de aanvraag die is gekoppeld aan de fout. |
ErrorResponseDetails
De details van het foutbericht.
| Naam | Type | Description |
|---|---|---|
| errorCode |
string |
Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is. |
| message |
string |
Een leesbare weergave van de fout. |
| parameters |
Gestructureerde parameters die extra machineleesbare context bieden over de fout. |
|
| relatedResource |
De foutgerelateerde resourcedetails. |
GroupDetails
Groepsspecifieke details. Van toepassing wanneer het principal-type is Group.
| Naam | Type | Description |
|---|---|---|
| groupType |
Het type groep. Er kunnen in de loop van de tijd extra groepstypen worden toegevoegd. |
GroupPrincipal
Vertegenwoordigt een beveiligingsgroep.
| Naam | Type | Description |
|---|---|---|
| displayName |
string |
De weergavenaam van de principal. |
| groupDetails |
Groepsspecifieke details. Van toepassing wanneer het principal-type is |
|
| id |
string (uuid) |
De id van de principal. |
| type |
string:
Group |
Het type principal. Er kunnen in de loop van de tijd extra principal-typen worden toegevoegd. |
GroupType
Het type groep. Er kunnen in de loop van de tijd extra groepstypen worden toegevoegd.
| Waarde | Description |
|---|---|
| Unknown |
Het type Principal-groep is onbekend. |
| SecurityGroup |
Principal is een beveiligingsgroep. |
| DistributionList |
Principal is een distributielijst. |
ItemTag
Vertegenwoordigt een tag die is toegepast op een item.
| Naam | Type | Description |
|---|---|---|
| displayName |
string |
De naam van de tag. |
| id |
string (uuid) |
De tag-id. |
ItemType
Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
| Waarde | Description |
|---|---|
| Dashboard |
PowerBI-dashboard. |
| Report |
PowerBI-rapport. |
| SemanticModel |
Semantisch Power BI-model. |
| PaginatedReport |
Gepagineerd Power BI-rapport. |
| Datamart |
PowerBI-datamart. |
| Lakehouse |
Een lakehouse. |
| Eventhouse |
Een eventhouse. |
| Environment |
Een omgeving. |
| KQLDatabase |
Een KQL-database. |
| KQLQueryset |
Een KQL-queryset. |
| KQLDashboard |
Een KQL-dashboard. |
| DataPipeline |
Een gegevenspijplijn. |
| Notebook |
Een notitieblok. |
| SparkJobDefinition |
Een Spark-taakdefinitie. |
| MLExperiment |
Een machine learning-experiment. |
| MLModel |
Een machine learning-model. |
| Warehouse |
Een magazijn. |
| Eventstream |
Een eventstream. |
| SQLEndpoint |
Een SQL-eindpunt. |
| MirroredWarehouse |
Een gespiegeld magazijn. |
| MirroredDatabase |
Een gespiegelde database. |
| Reflex |
Een reflex. |
| GraphQLApi |
Een API voor GraphQL-item. |
| MountedDataFactory |
Een MountedDataFactory. |
| SQLDatabase |
Een SQLDatabase. |
| CopyJob |
Een kopieertaak. |
| VariableLibrary |
Een VariableLibrary. |
| Dataflow |
Een gegevensstroom. |
| ApacheAirflowJob |
Een ApacheAirflowJob. |
| WarehouseSnapshot |
Een momentopname van een magazijn. |
| DigitalTwinBuilder |
Een DigitalTwinBuilder. |
| DigitalTwinBuilderFlow |
Een Digital Twin Builder Flow. |
| MirroredAzureDatabricksCatalog |
Een gespiegelde Azure Databricks-catalogus. |
| Map |
Een kaart. |
| AnomalyDetector |
Een Anomaly Detector. |
| UserDataFunction |
Een gebruikersgegevensfunctie. |
| GraphModel |
Een GraphModel. |
| GraphQuerySet |
Een Graph QuerySet. |
| SnowflakeDatabase |
Een Snowflake-database voor het opslaan van Iceberg-tabellen die zijn gemaakt op basis van het Snowflake-account. |
| OperationsAgent |
Een OperationsAgent. |
| CosmosDBDatabase |
Een Cosmos DB-database. |
| Ontology |
Een Ontologie. |
| EventSchemaSet |
Een EventSchemaSet. |
| DataAgent |
Een DataAgent. |
| MirroredCatalog |
Een mirroredCatalog. |
| PolicySet |
Een beleidsset. |
| AppBackend |
Een AppBackend. |
| OrgApp |
Een organisatie-app. |
| OrgAppAudience |
Een organisatie-app-doelgroep. |
| DataBuildToolJob |
Een DataBuildToolJob. |
| AzureDatabricksStorage |
Een door OneLake ondersteund opslagitem voor Azure Databricks. |
| Plan |
Een plan. |
| Monitoring |
Een bewakingsitem. |
| DeploymentPlan |
Een implementatieplan. |
| ShareSubscription |
Een abonnement delen. |
| Share |
Een share. |
| Playbook |
Een playbook. |
| MirroredOneLake |
Een gespiegeld OneLake-item. |
| PostgreSQLDatabase |
Een PostgreSQL-database-item in Microsoft Fabric. |
| CustomStreamConnector |
Een Custom Stream Connector-item in Microsoft Fabric. |
PayloadType
Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.
| Waarde | Description |
|---|---|
| InlineBase64 |
Inline base 64. |
PrincipalType
Het type principal. Er kunnen in de loop van de tijd extra principal-typen worden toegevoegd.
| Waarde | Description |
|---|---|
| User |
Principal is een Microsoft Entra user principal. |
| ServicePrincipal |
Principal is een Microsoft Entra service-principal. |
| Group |
Principal is een beveiligingsgroep. |
| ServicePrincipalProfile |
Principal is een service-principalprofiel. |
| EntireTenant |
Principal vertegenwoordigt alle tenantgebruikers. |
SemanticModel
Een semantisch modelobject.
| Naam | Type | Description |
|---|---|---|
| defaultIdentity | Principal: |
De standaardidentiteit van het item. |
| description |
string |
De beschrijving van het item. |
| displayName |
string |
De weergavenaam van het item. |
| folderId |
string (uuid) |
De map-id. |
| id |
string (uuid) |
De item-id. |
| logicalId |
string (uuid) |
De logische id van het item. Overeenkomende itemexemplaren delen dezelfde logische id. De waarde is null wanneer er geen logische id is toegewezen. |
| sensitivityLabel |
Het vertrouwelijkheidslabel voor items. |
|
| tags |
Item |
Lijst met toegepaste tags. |
| type |
Het itemtype. |
|
| workspaceId |
string (uuid) |
De werkruimte-id. |
SemanticModelCreationPayload
Nettolading maken voor het maken van een semantisch model zonder definitie.
| Naam | Type | Description |
|---|---|---|
| oneLakeTables |
string[] (uri) |
Een lijst met OneLake-tabel-URL's waarmee het semantische model kan worden verbonden (maximaal 100). Elke URL moet een van de twee indelingen volgen: |
SemanticModelDefinition
openbare Semantische modeldefinitie object. Raadpleeg dit artikel voor meer informatie over de structuur van de Semantische modeldefinitie.
| Naam | Type | Description |
|---|---|---|
| format |
string |
De indeling van de definitie van het semantische model. |
| parts |
Een lijst met definitieonderdelen. |
SemanticModelDefinitionPart
Semantisch modeldefinitieonderdeelobject.
| Naam | Type | Description |
|---|---|---|
| path |
string |
Het pad naar het semantische modelonderdeel. |
| payload |
string |
De nettolading van het semantische modelonderdeel. |
| payloadType |
Het nettoladingstype. |
SensitivityLabel
Vertegenwoordigt een vertrouwelijkheidslabel dat is toegepast op een item.
| Naam | Type | Description |
|---|---|---|
| id |
string (uuid) |
De vertrouwelijkheidslabel-id. |
SensitivityLabelApplyStrategy
De strategie voor het toepassen van het gevoeligheidslabel. De standaardwaarde is ApplyOrFail. Er kunnen in de loop van de tijd extra typen worden toegevoegd.
| Waarde | Description |
|---|---|
| ApplyOrFail |
Pas het vertrouwelijkheidslabel toe of mislukt de bewerking als deze niet kan worden toegepast. |
| Ignore |
Negeer het vertrouwelijkheidslabel als het niet kan worden toegepast en ga door met de bewerking zonder het label toe te passen. |
SensitivityLabelSettings
De instellingen voor vertrouwelijkheidslabels.
| Naam | Type | Description |
|---|---|---|
| labelId |
string (uuid) |
De vertrouwelijkheidslabel-id. |
| sensitivityLabelApplyStrategy |
De strategie voor het toepassen van het gevoeligheidslabel. |
ServicePrincipalDetails
Specifieke details van de service-principal. Van toepassing wanneer het principal-type is ServicePrincipal.
| Naam | Type | Description |
|---|---|---|
| aadAppId |
string (uuid) |
De Microsoft Entra AppId van de service-principal. |
ServicePrincipalPrincipal
Vertegenwoordigt een Microsoft Entra service-principal.
| Naam | Type | Description |
|---|---|---|
| displayName |
string |
De weergavenaam van de principal. |
| id |
string (uuid) |
De id van de principal. |
| servicePrincipalDetails |
Specifieke details van de service-principal. Van toepassing wanneer het principal-type is |
|
| type |
string:
Service |
Het type principal. Er kunnen in de loop van de tijd extra principal-typen worden toegevoegd. |
ServicePrincipalProfileDetails
Details van service-principalprofiel. Van toepassing wanneer het principal-type is ServicePrincipalProfile.
| Naam | Type | Description |
|---|---|---|
| parentPrincipal | Principal: |
De bovenliggende principal van het service-principalprofiel. |
ServicePrincipalProfilePrincipal
Vertegenwoordigt een service-principalprofiel.
| Naam | Type | Description |
|---|---|---|
| displayName |
string |
De weergavenaam van de principal. |
| id |
string (uuid) |
De id van de principal. |
| servicePrincipalProfileDetails |
Details van service-principalprofiel. Van toepassing wanneer het principal-type is |
|
| type |
string:
Service |
Het type principal. Er kunnen in de loop van de tijd extra principal-typen worden toegevoegd. |
UserDetails
Specifieke details van gebruikersprincipaal. Van toepassing wanneer het principal-type is User.
| Naam | Type | Description |
|---|---|---|
| userPrincipalName |
string |
De gebruikersprincipe-naam (UPN). |
UserPrincipal
Vertegenwoordigt een Microsoft Entra gebruikersprincipaal.
| Naam | Type | Description |
|---|---|---|
| displayName |
string |
De weergavenaam van de principal. |
| id |
string (uuid) |
De id van de principal. |
| type |
string:
User |
Het type principal. Er kunnen in de loop van de tijd extra principal-typen worden toegevoegd. |
| userDetails |
Specifieke details van gebruikersprincipaal. Van toepassing wanneer het principal-type is |