Dela via


Items - Create Semantic Model

Skapar en semantisk modell på den angivna arbetsytan.
Det här API:et stöder tidskrävande åtgärder (LRO).

Det här API:et kräver en definition.

Behörigheter

Anroparen måste ha deltagare eller högre arbetsyteroll.

Obligatoriska delegerade omfång

SemanticModel.ReadWrite.All eller Item.ReadWrite.All

Begränsningar

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet Stöd
Användare Ja
Tjänstens huvudnamn och hanterade identiteter Ja

Gränssnitt

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels

URI-parametrar

Name I Obligatorisk Typ Description
workspaceId
path True

string

uuid

Arbetsytans ID.

Begärandetext

Name Obligatorisk Typ Description
definition True

SemanticModelDefinition

Den offentliga definitionen för semantikmodellen.

displayName True

string

Visningsnamnet för den semantiska modellen. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.

description

string

Beskrivning av semantisk modell. Maximal längd är 256 tecken.

Svar

Name Typ Description
201 Created

SemanticModel

Har skapats

202 Accepted

Begäran accepterad, semantisk modelletablering pågår.

Sidhuvuden

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Vanliga felkoder:

  • InvalidItemType – Objekttypen är ogiltig.

  • ItemDisplayNameAlreadyInUse – Objektets visningsnamn används redan.

  • CorruptedPayload – den angivna nyttolasten är skadad.

Exempel

Create a semantic model example

Exempelbegäran

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"
      }
    ]
  }
}

Exempelsvar

{
  "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

Definitioner

Name Description
CreateSemanticModelRequest

Skapa nyttolasten för semantisk modellbegäran.

ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.

ErrorResponse

Felsvaret.

ErrorResponseDetails

Information om felsvar.

ItemType

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

PayloadType

Typ av definitionsdelens nyttolast. Ytterligare nyttolasttyper kan läggas till över tid.

SemanticModel

Ett semantiskt modellobjekt.

SemanticModelDefinition

offentlig definition av semantisk modell objekt.

SemanticModelDefinitionPart

Delobjekt för semantisk modelldefinition.

CreateSemanticModelRequest

Skapa nyttolasten för semantisk modellbegäran.

Name Typ Description
definition

SemanticModelDefinition

Den offentliga definitionen för semantikmodellen.

description

string

Beskrivning av semantisk modell. Maximal längd är 256 tecken.

displayName

string

Visningsnamnet för den semantiska modellen. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.

ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.

Name Typ Description
resourceId

string

Det resurs-ID som ingår i felet.

resourceType

string

Typen av resurs som är inblandad i felet.

ErrorResponse

Felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.

message

string

En mänsklig läsbar representation av felet.

moreDetails

ErrorResponseDetails[]

Lista över ytterligare felinformation.

relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.

requestId

string

ID för den begäran som är associerad med felet.

ErrorResponseDetails

Information om felsvar.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.

message

string

En mänsklig läsbar representation av felet.

relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.

ItemType

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

Värde Description
Dashboard

PowerBI-instrumentpanel.

DataPipeline

En datapipeline.

Datamart

PowerBI-datamart.

Environment

En miljö.

Eventhouse

Ett eventhouse.

Eventstream

En händelseström.

GraphQLApi

Ett API för GraphQL-objekt.

KQLDashboard

En KQL-instrumentpanel.

KQLDatabase

En KQL-databas.

KQLQueryset

En KQL-frågeuppsättning.

Lakehouse

Ett sjöhus.

MLExperiment

Ett maskininlärningsexperiment.

MLModel

En maskininlärningsmodell.

MirroredDatabase

En speglad databas.

MirroredWarehouse

Ett speglat lager.

MountedDataFactory

En MountedDataFactory.

Notebook

En notebook-fil.

PaginatedReport

Sidnumrerad PowerBI-rapport.

Reflex

En reflex.

Report

PowerBI-rapport.

SQLDatabase

En SQLDatabase.

SQLEndpoint

En SQL-slutpunkt.

SemanticModel

PowerBI-semantisk modell.

SparkJobDefinition

En definition för Spark-jobb.

Warehouse

Ett lager.

PayloadType

Typ av definitionsdelens nyttolast. Ytterligare nyttolasttyper kan läggas till över tid.

Värde Description
InlineBase64

Infogad bas 64.

SemanticModel

Ett semantiskt modellobjekt.

Name Typ Description
description

string

Objektbeskrivningen.

displayName

string

Objektets visningsnamn.

id

string

uuid

Objekt-ID:t.

type

ItemType

Objekttypen.

workspaceId

string

uuid

Arbetsytans ID.

SemanticModelDefinition

offentlig definition av semantisk modell objekt.

Name Typ Description
format

string

Formatet för objektdefinitionen.

parts

SemanticModelDefinitionPart[]

En lista över definitionsdelar.

SemanticModelDefinitionPart

Delobjekt för semantisk modelldefinition.

Name Typ Description
path

string

Den semantiska modelldelssökvägen.

payload

string

Den semantiska modelldelens nyttolast.

payloadType

PayloadType

Nyttolasttypen.