Items - Create Semantic Model
Hiermee maakt u een semantisch model in de opgegeven werkruimte.
Deze API ondersteunt langlopende bewerkingen (LRO).
Voor deze API is een definitievereist.
Machtigingen
De aanroeper moet inzender hebben of een hogere werkruimterol.
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.
Door Microsoft Entra ondersteunde identiteiten
Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.
Identiteit | Steunen |
---|---|
Gebruiker | Ja |
service-principal en beheerde identiteiten | Ja |
Interface
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
De werkruimte-id. |
Aanvraagbody
Name | Vereist | Type | Description |
---|---|---|---|
definition | True |
De openbare definitie van het semantische model. |
|
displayName | True |
string |
De weergavenaam van het semantische model. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype. |
description |
string |
De beschrijving van het semantische model. De maximale lengte is 256 tekens. |
Antwoorden
Name | Type | Description |
---|---|---|
201 Created |
Gemaakt |
|
202 Accepted |
Aanvraag geaccepteerd, semantisch model inrichten wordt uitgevoerd. Kopteksten
|
|
Other Status Codes |
Veelvoorkomende foutcodes:
|
Voorbeelden
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"
}
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
Name | Description |
---|---|
Create |
Maak de nettolading van semantische modelaanvragen. |
Error |
Het foutgerelateerde resourcedetailsobject. |
Error |
Het foutbericht. |
Error |
De details van het foutbericht. |
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. |
Semantic |
Een semantisch modelobject. |
Semantic |
|
Semantic |
Semantisch modeldefinitieonderdeelobject. |
CreateSemanticModelRequest
Maak de nettolading van semantische modelaanvragen.
Name | Type | Description |
---|---|---|
definition |
De openbare definitie van het semantische model. |
|
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. |
ErrorRelatedResource
Het foutgerelateerde resourcedetailsobject.
Name | 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.
Name | 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. |
moreDetails |
Lijst met aanvullende foutdetails. |
|
relatedResource |
De foutgerelateerde resourcedetails. |
|
requestId |
string |
Id van de aanvraag die is gekoppeld aan de fout. |
ErrorResponseDetails
De details van het foutbericht.
Name | 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. |
relatedResource |
De foutgerelateerde resourcedetails. |
ItemType
Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
Waarde | Description |
---|---|
Dashboard |
PowerBI-dashboard. |
DataPipeline |
Een gegevenspijplijn. |
Datamart |
PowerBI-datamart. |
Environment |
Een omgeving. |
Eventhouse |
Een eventhouse. |
Eventstream |
Een eventstream. |
GraphQLApi |
Een API voor GraphQL-item. |
KQLDashboard |
Een KQL-dashboard. |
KQLDatabase |
Een KQL-database. |
KQLQueryset |
Een KQL-queryset. |
Lakehouse |
Een lakehouse. |
MLExperiment |
Een machine learning-experiment. |
MLModel |
Een machine learning-model. |
MirroredDatabase |
Een gespiegelde database. |
MirroredWarehouse |
Een gespiegeld magazijn. |
MountedDataFactory |
Een MountedDataFactory. |
Notebook |
Een notitieblok. |
PaginatedReport |
Gepagineerd Power BI-rapport. |
Reflex |
Een reflex. |
Report |
PowerBI-rapport. |
SQLDatabase |
Een SQLDatabase. |
SQLEndpoint |
Een SQL-eindpunt. |
SemanticModel |
Semantisch Power BI-model. |
SparkJobDefinition |
Een Spark-taakdefinitie. |
Warehouse |
Een magazijn. |
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. |
SemanticModel
Een semantisch modelobject.
Name | Type | Description |
---|---|---|
description |
string |
De beschrijving van het item. |
displayName |
string |
De weergavenaam van het item. |
id |
string uuid |
De item-id. |
type |
Het itemtype. |
|
workspaceId |
string uuid |
De werkruimte-id. |
SemanticModelDefinition
openbare Semantische modeldefinitie object.
Name | Type | Description |
---|---|---|
format |
string |
De indeling van de itemdefinitie. |
parts |
Een lijst met definitieonderdelen. |
SemanticModelDefinitionPart
Semantisch modeldefinitieonderdeelobject.
Name | Type | Description |
---|---|---|
path |
string |
Het pad naar het semantische modelonderdeel. |
payload |
string |
De nettolading van het semantische modelonderdeel. |
payloadType |
Het nettoladingstype. |