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
- Anlamsal model oluşturmak için kullanıcının uygun lisansa sahip olması gerekir. Daha fazla bilgi için bkz. Microsoft Fabric lisans türleri.
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 |
|---|---|---|---|---|
|
workspace
|
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 |
Tam tanım olmadan anlamsal model oluşturmaya yönelik oluşturma yükü. DirectLake modeli oluşturmak veya hem hem de |
||
| definition |
Semantik model genel tanımı.
|
||
| 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 |
Anlam modeli için duyarlılık etiketi ayarları. |
Yanıtlar
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| 201 Created |
Başarıyla oluşturuldu |
|
| 202 Accepted |
İstek kabul edildi, anlamsal model sağlama devam ediyor. Üst Bilgiler
|
|
| 429 Too Many Requests |
Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Üst Bilgiler Retry-After: integer |
|
| Other Status Codes |
Yaygın hata kodları:
|
Örnekler
| Create a semantic model example |
|
Create a semantic model with One |
| 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 |
|---|---|
|
Create |
Anlam modeli istek yükü oluşturun. |
|
Entire |
Kiracı sorumlusunu temsil eder |
|
Error |
Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre. |
|
Error |
Hatayla ilgili kaynak ayrıntıları nesnesi. |
|
Error |
Hata yanıtı. |
|
Error |
Hata yanıtı ayrıntıları. |
|
Group |
Belirli ayrıntıları gruplandırma. Sorumlu türü |
|
Group |
Bir güvenlik grubunu temsil eder. |
|
Group |
Grubun türü. Zaman içinde ek grup türleri eklenebilir. |
|
Item |
Bir öğeye uygulanan etiketi temsil eder. |
|
Item |
Öğenin türü. Zaman içinde ek öğe türleri eklenebilir. |
|
Payload |
Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir. |
|
Principal |
Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir. |
|
Semantic |
Anlamsal model nesnesi. |
|
Semantic |
Tanım olmadan anlamsal model oluşturmak için oluşturma yükü. |
|
Semantic |
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. |
|
Semantic |
Anlamsal model tanımı parça nesnesi. |
|
Sensitivity |
Bir öğeye uygulanan duyarlılık etiketini temsil eder. |
|
Sensitivity |
Duyarlılık etiketini uygulama stratejisi. Varsayılan değer ApplyOrFail'dir. Zaman içinde ek türler eklenebilir. |
|
Sensitivity |
Duyarlılık etiketi ayarları. |
|
Service |
Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü |
|
Service |
Microsoft Entra hizmet sorumlusunu temsil eder. |
|
Service |
Hizmet sorumlusu profili ayrıntıları. Sorumlu türü |
|
Service |
Hizmet sorumlusu profilini temsil eder. |
|
User |
Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü |
|
User |
Microsoft Entra kullanıcı sorumlusunu temsil eder. |
CreateSemanticModelRequest
Anlam modeli istek yükü oluşturun.
| Veri Akışı Adı | Tür | Description |
|---|---|---|
| creationPayload |
Tam tanım olmadan anlamsal model oluşturmaya yönelik oluşturma yükü. DirectLake modeli oluşturmak veya hem hem de |
|
| definition |
Semantik model genel tanımı.
|
|
| 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 |
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:
Entire |
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 |
| message |
string |
Hatanın okunabilir bir gösterimi. |
| moreDetails |
Ek hata ayrıntılarının listesi. |
|
| parameters |
Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler. |
|
| relatedResource |
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 |
Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler. |
|
| relatedResource |
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 |
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 |
Belirli ayrıntıları gruplandırma. Sorumlu türü |
|
| 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 |
Öğe duyarlılığı etiketi. |
|
| tags |
Item |
Uygulanan etiketlerin listesi. |
| type |
Öğ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: |
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 |
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 |
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 |
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 |
Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü |
|
| type |
string:
Service |
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 |
Hizmet sorumlusu profili ayrıntıları. Sorumlu türü |
|
| type |
string:
Service |
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 |
Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü |