Items - Get SQL Database Definition

Hizmet:: SQLDatabase

API Sürümü:: v1

Belirtilen SQL veritabanı genel tanımını döndürür.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

SQL veritabanının genel tanımını aldığınızda duyarlılık etiketi tanımın bir parçası değildir.

Permissions

Çağıranın SQL veritabanı için okuma ve yazma izinlerine sahip olması gerekir.

Gerekli Temsilci Kapsamları

SQLDatabase.ReadWrite.All veya Item.ReadWrite.All

Microsoft Entra destekli kimlikler

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

Kimlik	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Arayüz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/{sqlDatabaseId}/getDefinition

İsteğe bağlı parametrelerle:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/{sqlDatabaseId}/getDefinition?format={format}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
sqlDatabaseId	path	True	string (uuid)	SQL veritabanı kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.
format	query		string	SQL veritabanı genel tanımının biçimi.

Yanıtlar

Name	Tür	Description
200 OK	SQLDatabaseDefinitionResponse	İstek başarıyla tamamlandı.
202 Accepted		İstek kabul edildi. Tanımı alma işlemi 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.

Örnekler

Get a Digital Twin Builder Flow public definition example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/sqlDatabases/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/getDefinition

Örnek yanıt

Durum kodu:: 200

{
  "definition": {
    "parts": [
      {
        "path": "definition.dacpac",
        "payload": "ew0KICAibGFrZWhvdXNlSWQiOiAiYjliNWQzNmYtNDQ0NS00MDNiLWFjODctMDE2YjFjZDIwMjExIg0KfQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Durum kodu:: 202

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

Name	Description
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.
SQLDatabaseDefinition	SQL veritabanı genel tanım nesnesi. SQL veritabanı tanımının yapısı hakkında daha fazla ayrıntı için bu makaleye bakın.
SQLDatabaseDefinitionResponse	SQL veritabanı genel tanım yanıtı.
SQLDatabasePublicDefinitionPart	SQL veritabanı tanımı parça nesnesi.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

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

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

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

SQLDatabaseDefinition

Nesne

SQL veritabanı genel tanım nesnesi. SQL veritabanı tanımının yapısı hakkında daha fazla ayrıntı için bu makaleye bakın.

Name	Tür	Description
format	string	SQL veritabanı tanımının biçimi.
parts	SQLDatabasePublicDefinitionPart[]	Tanım bölümlerinin listesi.

SQLDatabaseDefinitionResponse

Nesne

SQL veritabanı genel tanım yanıtı.

Name	Tür	Description
definition	SQLDatabaseDefinition	SQL veritabanı genel tanım nesnesi. SQL veritabanı tanımının yapısı hakkında daha fazla ayrıntı için bu makaleye bakın.

SQLDatabasePublicDefinitionPart

Nesne

SQL veritabanı tanımı parça nesnesi.

Name	Tür	Description
path	string	SQL veritabanı genel tanımı bölüm yolu.
payload	string	SQL veritabanı genel tanımı parça yükü.
payloadType	PayloadType	Yük türü.