Items - Create Semantic Model

Belirtilen çalışma alanında bir anlam modeli oluşturur.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

API üç oluşturma modunu destekler: (1) model yapısı üzerinde tam denetim sağlar definition , (2) DirectLake modeli oluşturmak için OneLake tablo URL'leri sağlar creationPayload veya (3) boş bir anlam modeli oluşturmak için ikisini de atlar. definition veya creationPayload kullanın. İkisini de aynı anda kullanamazsınız.

İzinler

Çağıranın katkıda bulunan çalışma alanı rolü olmalıdır. OneLake tablolarına başvuran ile bir creationPayload DirectLake modeli oluştururken, çağıranın, bu kaynakların farklı bir çalışma alanında (çalışma alanları arası kaynaklar) bulunması da dahil olmak üzere başvuruda bulunılan her bir kaynak Lakehouse veya veri öğesine de erişimi olmalıdır.

Gerekli Temsilci Kapsamları

SemanticModel.ReadWrite.All veya Item.ReadWrite.All

Sınırlama

Desteklenen kimlikleri Microsoft Entra

Bu API, bu bölümde listelenen Microsoft identities destekler.

Kimlik Destek
Kullanıcı Evet
Hizmet sorumlusu ve yönetilen kimlikler Evet

Arayüz

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

URI Parametreleri

Veri Akışı Adı İçinde Gerekli Tür Description
workspaceId
path True

string (uuid)

Çalışma alanı kimliği.

İstek Gövdesi

Veri Akışı Adı Gerekli Tür Description
displayName True

string

Anlamsal modelin görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.

creationPayload

SemanticModelCreationPayload

Tam tanım olmadan anlamsal model oluşturmaya yönelik oluşturma yükü. DirectLake modeli oluşturmak veya hem hem de definitioncreationPayload boş bir anlam modeli oluşturmak için OneLake tablo URL'lerini sağlayın. definition veya creationPayload kullanın. İkisini de aynı anda kullanamazsınız.

definition

SemanticModelDefinition

Semantik model genel tanımı. definition veya creationPayload kullanın. İkisini de aynı anda kullanamazsınız.

description

string

Anlamsal model açıklaması. Uzunluk üst sınırı 256 karakterdir.

folderId

string (uuid)

Klasör kimliği. Belirtilmezse veya null değilse, semantik model çalışma alanı klasörü olarak oluşturulur.

sensitivityLabelSettings

SensitivityLabelSettings

Anlam modeli için duyarlılık etiketi ayarları.

Yanıtlar

Veri Akışı Adı Tür Description
201 Created

SemanticModel

Başarıyla oluşturuldu

202 Accepted

İstek kabul edildi, anlamsal model sağlama devam ediyor.

Üst Bilgiler

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

Retry-After: integer

Other Status Codes

ErrorResponse

Yaygın hata kodları:

  • ItemDisplayNameAlreadyInUse - Öğe görünen adı zaten kullanılıyor.

  • BozukPayload - Sağlanan yük bozuk.

  • MutuallyExclusiveProperties - definition ve creationPayload her ikisi de sağlanamaz.

  • InvalidOneLakeTableUrl - Bir veya daha fazla OneLake tablo URL'si geçersiz.

  • DuplicateTableName - Yinelenen tablo adlara izin verilmez.

Örnekler

Create a semantic model example
Create a semantic model with OneLake tables example
Create an empty semantic model example

Create a semantic model example

Örnek isteği

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

Örnek yanıt

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

Örnek isteği

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

Örnek yanıt

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

Örnek isteği

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/semanticModels

{
  "displayName": "SemanticModel 1",
  "description": "An empty semantic model."
}

Örnek yanıt

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

Tanımlar

Veri Akışı Adı Description
CreateSemanticModelRequest

Anlam modeli istek yükü oluşturun.

EntireTenantPrincipal

Kiracı sorumlusunu temsil eder

ErrorParameter

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları nesnesi.

ErrorResponse

Hata yanıtı.

ErrorResponseDetails

Hata yanıtı ayrıntıları.

GroupDetails

Belirli ayrıntıları gruplandırma. Sorumlu türü Groupolduğunda geçerlidir.

GroupPrincipal

Bir güvenlik grubunu temsil eder.

GroupType

Grubun türü. Zaman içinde ek grup türleri eklenebilir.

ItemTag

Bir öğeye uygulanan etiketi temsil eder.

ItemType

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

PayloadType

Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.

PrincipalType

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

SemanticModel

Anlamsal model nesnesi.

SemanticModelCreationPayload

Tanım olmadan anlamsal model oluşturmak için oluşturma yükü.

SemanticModelDefinition

Anlam modeli genel tanımı nesnesi. Anlam modeli tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.

SemanticModelDefinitionPart

Anlamsal model tanımı parça nesnesi.

SensitivityLabel

Bir öğeye uygulanan duyarlılık etiketini temsil eder.

SensitivityLabelApplyStrategy

Duyarlılık etiketini uygulama stratejisi. Varsayılan değer ApplyOrFail'dir. Zaman içinde ek türler eklenebilir.

SensitivityLabelSettings

Duyarlılık etiketi ayarları.

ServicePrincipalDetails

Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü ServicePrincipalolduğunda geçerlidir.

ServicePrincipalPrincipal

Microsoft Entra hizmet sorumlusunu temsil eder.

ServicePrincipalProfileDetails

Hizmet sorumlusu profili ayrıntıları. Sorumlu türü ServicePrincipalProfileolduğunda geçerlidir.

ServicePrincipalProfilePrincipal

Hizmet sorumlusu profilini temsil eder.

UserDetails

Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü Userolduğunda geçerlidir.

UserPrincipal

Microsoft Entra kullanıcı sorumlusunu temsil eder.

CreateSemanticModelRequest

Anlam modeli istek yükü oluşturun.

Veri Akışı Adı Tür Description
creationPayload

SemanticModelCreationPayload

Tam tanım olmadan anlamsal model oluşturmaya yönelik oluşturma yükü. DirectLake modeli oluşturmak veya hem hem de definitioncreationPayload boş bir anlam modeli oluşturmak için OneLake tablo URL'lerini sağlayın. definition veya creationPayload kullanın. İkisini de aynı anda kullanamazsınız.

definition

SemanticModelDefinition

Semantik model genel tanımı. definition veya creationPayload kullanın. İkisini de aynı anda kullanamazsınız.

description

string

Anlamsal model açıklaması. Uzunluk üst sınırı 256 karakterdir.

displayName

string

Anlamsal modelin görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.

folderId

string (uuid)

Klasör kimliği. Belirtilmezse veya null değilse, semantik model çalışma alanı klasörü olarak oluşturulur.

sensitivityLabelSettings

SensitivityLabelSettings

Anlam modeli için duyarlılık etiketi ayarları.

EntireTenantPrincipal

Kiracı sorumlusunu temsil eder

Veri Akışı Adı Tür Description
displayName

string

Sorumlunun görünen adı.

id

string (uuid)

Sorumlunun kimliği.

type string:

EntireTenant

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

ErrorParameter

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

Veri Akışı Adı Tür Description
message

string

Parametrenin anlamının insan tarafından okunabilen açıklaması.

name

string

Parametre tanımlayıcısı.

value

string

Parametre değeridir.

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları nesnesi.

Veri Akışı Adı Tür Description
resourceId

string

Hataya dahil olan kaynak kimliği.

resourceType

string

Hataya dahil olan kaynağın türü.

ErrorResponse

Hata yanıtı.

Veri Akışı Adı Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.

isRetriable

boolean

True olduğunda istek yeniden denenebilir. Varsa gecikmeyi Retry-After belirlemek için yanıt üst bilgisini kullanın.

message

string

Hatanın okunabilir bir gösterimi.

moreDetails

ErrorResponseDetails[]

Ek hata ayrıntılarının listesi.

parameters

ErrorParameter[]

Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.

relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.

requestId

string (uuid)

Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Hata yanıtı ayrıntıları.

Veri Akışı Adı Tür Description
errorCode

string

Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.

message

string

Hatanın okunabilir bir gösterimi.

parameters

ErrorParameter[]

Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.

relatedResource

ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları.

GroupDetails

Belirli ayrıntıları gruplandırma. Sorumlu türü Groupolduğunda geçerlidir.

Veri Akışı Adı Tür Description
groupType

GroupType

Grubun türü. Zaman içinde ek grup türleri eklenebilir.

GroupPrincipal

Bir güvenlik grubunu temsil eder.

Veri Akışı Adı Tür Description
displayName

string

Sorumlunun görünen adı.

groupDetails

GroupDetails

Belirli ayrıntıları gruplandırma. Sorumlu türü Groupolduğunda geçerlidir.

id

string (uuid)

Sorumlunun kimliği.

type string:

Group

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

GroupType

Grubun türü. Zaman içinde ek grup türleri eklenebilir.

Değer Description
Unknown

Asıl grup türü bilinmiyor.

SecurityGroup

Sorumlu bir güvenlik grubudur.

DistributionList

Sorumlu bir dağıtım listesidir.

ItemTag

Bir öğeye uygulanan etiketi temsil eder.

Veri Akışı Adı Tür Description
displayName

string

Etiketin adı.

id

string (uuid)

Etiket kimliği.

ItemType

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer Description
Dashboard

PowerBI panosu.

Report

PowerBI raporu.

SemanticModel

PowerBI anlam modeli.

PaginatedReport

PowerBI sayfalandırılmış raporu.

Datamart

PowerBI datamart.

Lakehouse

Göl evi.

Eventhouse

Bir olay evi.

Environment

Bir ortam.

KQLDatabase

KQL veritabanı.

KQLQueryset

KQL sorgu kümesi.

KQLDashboard

KQL panosu.

DataPipeline

Veri işlem hattı.

Notebook

Bir not defteri.

SparkJobDefinition

Spark iş tanımı.

MLExperiment

Makine öğrenmesi denemesi.

MLModel

Makine öğrenmesi modeli.

Warehouse

Bir depo.

Eventstream

Bir olay akışı.

SQLEndpoint

Bir SQL uç noktası.

MirroredWarehouse

Aynalı bir depo.

MirroredDatabase

Yansıtılmış veritabanı.

Reflex

Bir refleks.

GraphQLApi

GraphQL öğesi için bir API.

MountedDataFactory

Bir MountedDataFactory.

SQLDatabase

A SQLDatabase.

CopyJob

Kopyalama işi.

VariableLibrary

Bir VariableLibrary.

Dataflow

Veri akışı.

ApacheAirflowJob

An ApacheAirflowJob.

WarehouseSnapshot

Ambar anlık görüntüsü.

DigitalTwinBuilder

A DigitalTwinBuilder.

DigitalTwinBuilderFlow

Dijital İkiz Oluşturucu Akışı.

MirroredAzureDatabricksCatalog

Yansıtılmış azure databricks kataloğu.

Map

Bir harita.

AnomalyDetector

Anomali Algılayıcısı.

UserDataFunction

Kullanıcı Verileri İşlevi.

GraphModel

A GraphModel.

GraphQuerySet

A Graph QuerySet.

SnowflakeDatabase

Snowflake hesabından oluşturulan Iceberg tablolarını depolamak için bir Snowflake Veritabanı.

OperationsAgent

A OperationsAgent.

CosmosDBDatabase

Cosmos DB Veritabanı.

Ontology

Bir Ontoloji.

EventSchemaSet

Bir EventSchemaSet.

DataAgent

A DataAgent.

MirroredCatalog

A MirroredCatalog.

PolicySet

İlke Kümesi.

AppBackend

An AppBackend.

OrgApp

Kuruluş uygulaması.

OrgAppAudience

Kuruluş Uygulaması Hedef Kitlesi.

DataBuildToolJob

A DataBuildToolJob.

AzureDatabricksStorage

Azure Databricks için OneLake destekli bir depolama öğesi.

Plan

Bir plan.

Monitoring

İzleme öğesi.

DeploymentPlan

Dağıtım planı.

PayloadType

Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.

Değer Description
InlineBase64

Satır içi Temel 64.

PrincipalType

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

Değer Description
User

Sorumlu, Microsoft Entra kullanıcı sorumlusudur.

ServicePrincipal

Sorumlu bir Microsoft Entra hizmet sorumlusudur.

Group

Sorumlu bir güvenlik grubudur.

ServicePrincipalProfile

Sorumlu bir hizmet sorumlusu profilidir.

EntireTenant

Sorumlu, tüm kiracı kullanıcılarını temsil eder.

SemanticModel

Anlamsal model nesnesi.

Veri Akışı Adı Tür Description
defaultIdentity Principal:

Öğenin varsayılan kimliği.

description

string

Öğe açıklaması.

displayName

string

Öğenin görünen adı.

folderId

string (uuid)

Klasör kimliği.

id

string (uuid)

Öğe kimliği.

logicalId

string (uuid)

Öğenin mantıksal tanımlayıcısı. Karşılık gelen öğe örnekleri aynı mantıksal kimliği paylaşır. Hiçbir mantıksal kimlik atanmadığında değer null olur.

sensitivityLabel

SensitivityLabel

Öğe duyarlılığı etiketi.

tags

ItemTag[]

Uygulanan etiketlerin listesi.

type

ItemType

Öğe türü.

workspaceId

string (uuid)

Çalışma alanı kimliği.

SemanticModelCreationPayload

Tanım olmadan anlamsal model oluşturmak için oluşturma yükü.

Veri Akışı Adı Tür Description
oneLakeTables

string[] (uri)

Semantik modeli bağlamak için OneLake tablo URL'lerinin listesi (en fazla 100). Her URL iki biçimden birini izlemelidir: https://onelake.dfs.fabric.microsoft.com/{workspaceId}/{dataItemId}/Tables/{tableName} varsayılan dbo şemadaki bir tablo için veya https://onelake.dfs.fabric.microsoft.com/{workspaceId}/{dataItemId}/Tables/{schemaName}/{tableName} açık özel şemadaki bir tablo için. URL'ler farklı çalışma alanlarına ve veri öğelerine başvurabilir ve tek bir istek varsayılan şema ve özel şema URL'lerini bir araya getirebilir. Sistem, OneLake kaynağından tablo adlarını ve sütunlarını çıkarsar.

SemanticModelDefinition

Anlam modeli genel tanımı nesnesi. Anlam modeli tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.

Veri Akışı Adı Tür Description
format

string

Anlam modeli tanımının biçimi.

parts

SemanticModelDefinitionPart[]

Tanım bölümlerinin listesi.

SemanticModelDefinitionPart

Anlamsal model tanımı parça nesnesi.

Veri Akışı Adı Tür Description
path

string

Anlamsal model parça yolu.

payload

string

Anlamsal model parça yükü.

payloadType

PayloadType

Yük türü.

SensitivityLabel

Bir öğeye uygulanan duyarlılık etiketini temsil eder.

Veri Akışı Adı Tür Description
id

string (uuid)

Duyarlılık etiketi kimliği.

SensitivityLabelApplyStrategy

Duyarlılık etiketini uygulama stratejisi. Varsayılan değer ApplyOrFail'dir. Zaman içinde ek türler eklenebilir.

Değer Description
ApplyOrFail

Duyarlılık etiketini uygulayın veya uygulanamıyorsa işlem başarısız olur.

Ignore

Uygulanamıyorsa duyarlılık etiketini yoksayın ve etiketi uygulamadan işleme devam edin.

SensitivityLabelSettings

Duyarlılık etiketi ayarları.

Veri Akışı Adı Tür Description
labelId

string (uuid)

Duyarlılık etiketi kimliği.

sensitivityLabelApplyStrategy

SensitivityLabelApplyStrategy

Duyarlılık etiketini uygulama stratejisi.

ServicePrincipalDetails

Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü ServicePrincipalolduğunda geçerlidir.

Veri Akışı Adı Tür Description
aadAppId

string (uuid)

Hizmet sorumlusunun Microsoft Entra AppId değeri.

ServicePrincipalPrincipal

Microsoft Entra hizmet sorumlusunu temsil eder.

Veri Akışı Adı Tür Description
displayName

string

Sorumlunun görünen adı.

id

string (uuid)

Sorumlunun kimliği.

servicePrincipalDetails

ServicePrincipalDetails

Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü ServicePrincipalolduğunda geçerlidir.

type string:

ServicePrincipal

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

ServicePrincipalProfileDetails

Hizmet sorumlusu profili ayrıntıları. Sorumlu türü ServicePrincipalProfileolduğunda geçerlidir.

Veri Akışı Adı Tür Description
parentPrincipal Principal:

Hizmet sorumlusu profilinin üst sorumlusu.

ServicePrincipalProfilePrincipal

Hizmet sorumlusu profilini temsil eder.

Veri Akışı Adı Tür Description
displayName

string

Sorumlunun görünen adı.

id

string (uuid)

Sorumlunun kimliği.

servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Hizmet sorumlusu profili ayrıntıları. Sorumlu türü ServicePrincipalProfileolduğunda geçerlidir.

type string:

ServicePrincipalProfile

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

UserDetails

Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü Userolduğunda geçerlidir.

Veri Akışı Adı Tür Description
userPrincipalName

string

Kullanıcı asıl adı.

UserPrincipal

Microsoft Entra kullanıcı sorumlusunu temsil eder.

Veri Akışı Adı Tür Description
displayName

string

Sorumlunun görünen adı.

id

string (uuid)

Sorumlunun kimliği.

type string:

User

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

userDetails

UserDetails

Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü Userolduğunda geçerlidir.