Items - Update Semantic Model Definition

Hizmet:
SemanticModel
API Sürümü:
v1

Belirtilen semantik modelin tanımını geçersiz kılar.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

Anlamsal modelin tanımının güncelleştirilmesi, duyarlılık etiketini etkilemez.

İzinler

Çağıranın anlam modeli için okuma ve yazma izinleri olmalıdır.

Gerekli Temsilci Kapsamları

SemanticModel.ReadWrite.All veya Item.ReadWrite.All

Microsoft Entra destekli kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini 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/{semanticModelId}/updateDefinition
İsteğe bağlı parametrelerle: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels/{semanticModelId}/updateDefinition?updateMetadata={updateMetadata}

URI Parametreleri

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

string (uuid)

Anlamsal model kimliği.
workspaceId
 path True

string (uuid)

Çalışma alanı kimliği.
updateMetadata
 query

boolean

True olarak ayarlandığında ve .platform dosyası tanımın bir parçası olarak sağlandığında, öğenin meta verileri .platform dosyasındaki meta veriler kullanılarak güncelleştirilir

İstek Gövdesi

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

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.
options

SemanticModelDefinitionOptions

Tanımı güncelleştirilmekte olan anlamsal modelin seçenekleri.

Yanıtlar

Veri Akışı Adı Tür Description
200 OK

İstek başarıyla tamamlandı.
202 Accepted

İstek kabul edildi. Güncelleştirme tanımı 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ı:

  • OperationNotSupportedForItem - İstenen öğe için işlem desteklenmiyor.

  • BozukPayload - Sağlanan yük bozuk.

Örnekler

Update a semantic model definition example

Örnek isteği

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/semanticModels/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "model.bim",
        "payload": "ewogICJjb21wYXRpYmlsaXR5TGV2ZW..GVzIjogWyBdDQogIH0NCn0",
        "payloadType": "InlineBase64"
      },
      {
        "path": "definition.pbism",
        "payload": "ewogICJ2ZXJzaW9uIjogIjQuMC..HRpbmdzIjoge30KfQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Örnek yanıt

Durum kodu:
200
Durum kodu:
202 
Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

Tanımlar

Veri Akışı Adı Description
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ı.
PayloadType

Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.
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.
SemanticModelDefinitionOptions

Bir tanım ile anlamsal model oluştururken veya bir anlam modelinin tanımını güncelleştirirken uygulanan seçenekler.
SemanticModelDefinitionPart

Anlamsal model tanımı parça nesnesi.
UpdateSemanticModelDefinitionRequest

Anlam modeli genel tanım isteği yükünü güncelleştirin.

ErrorParameter

Nesne

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

Nesne

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

Nesne

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

Nesne

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ı.

PayloadType

Numaralandırma

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.

SemanticModelDefinition

Nesne

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.

SemanticModelDefinitionOptions

Nesne

Bir tanım ile anlamsal model oluştururken veya bir anlam modelinin tanımını güncelleştirirken uygulanan seçenekler.

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

boolean

Güncelleştirilmiş tanımı uygularken anlamsal modelin mevcut verilerini temizlemeye izin verilip verilmeyeceği. Bazı tanım değişiklikleri mevcut verilerin temizlenmesini gerektirir; bu değişikliklerin devam etmelerine izin vermek için bunu true olarak ayarlayın; bu durumda yeni tanım altında tutulamayan tüm veriler temizlenir. İşlem tamamlandıktan sonra verileri yeniden yüklemek için anlam modelini yenileyin. Varsayılan değer yanlış'tır.

SemanticModelDefinitionPart

Nesne

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ü.

UpdateSemanticModelDefinitionRequest

Nesne

Anlam modeli genel tanım isteği yükünü güncelleştirin.

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

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.
options

SemanticModelDefinitionOptions

Tanımı güncelleştirilmekte olan anlamsal modelin seçenekleri.