Items - Get SQL Database Definition
Gibt die angegebene öffentliche SQL-Datenbankdefinition zurück.
Diese API unterstützt LRO-.
Wenn Sie die öffentliche Definition einer SQL-Datenbank erhalten, ist die Vertraulichkeitsbezeichnung nicht Teil der Definition.
Erlaubnisse
Der Aufrufer muss Über Lese- und Schreibberechtigungen für die SQL-Datenbank verfügen.
Erforderliche delegierte Bereiche
SQLDatabase.ReadWrite.All oder Item.ReadWrite.All
Limitations
Um die Definition eines SQL-Datenbankelements abzurufen, das durch eine verschlüsselte Vertraulichkeitsbezeichnung geschützt ist, muss der Aufrufer über ausreichende Nutzungsrechte verfügen, um die Bezeichnung zu entfernen, wie in Microsoft Purview konfiguriert.
Von Microsoft Entra unterstützte Identitäten
Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.
| Identität | Support |
|---|---|
| Benutzer | Yes |
| Service Principal und Verwaltete Identitäten | Yes |
Schnittstelle
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/{sqlDatabaseId}/getDefinition
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/{sqlDatabaseId}/getDefinition?format={format}
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
sql
|
path | True |
string (uuid) |
Die SQL-Datenbank-ID. |
|
workspace
|
path | True |
string (uuid) |
Die Arbeitsbereichs-ID. |
|
format
|
query |
string |
Das Format der öffentlichen SQL-Datenbankdefinition. Unterstütztes Format: |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Anforderung wurde erfolgreich abgeschlossen. |
|
| 202 Accepted |
Anforderung angenommen. Das Abrufen der Definition wird ausgeführt. Header
|
|
| 429 Too Many Requests |
Der Dienstratengrenzwert wurde überschritten. Der Server gibt einen Header Retry-After: integer |
|
| Other Status Codes |
Häufige Fehlercodes:
|
Beispiele
Get a Digital Twin Builder Flow public definition example
Beispielanforderung
POST https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/sqlDatabases/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87/getDefinition
Beispiel für eine Antwort
{
"definition": {
"parts": [
{
"path": "definition.dacpac",
"payload": "ew0KICAibGFrZWhvdXNlSWQiOiAiYjliNWQzNmYtNDQ0NS00MDNiLWFjODctMDE2YjFjZDIwMjExIg0KfQ==",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
"payloadType": "InlineBase64"
}
]
}
}
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
Definitionen
| Name | Beschreibung |
|---|---|
|
Error |
Ein strukturierter Parameter, der zusätzlichen computerlesbaren Kontext zu einem Fehler bereitstellt. |
|
Error |
Das Fehlerbezogene Ressourcendetails-Objekt. |
|
Error |
Die Fehlerantwort. |
|
Error |
Die Fehlerantwortdetails. |
|
Payload |
Der Typ der Definitionsteilnutzlast. Zusätzliche Nutzlasttypen können im Laufe der Zeit hinzugefügt werden. |
|
SQLDatabase |
Das öffentliche SQL-Datenbankdefinitionsobjekt. Weitere Informationen zur Struktur der SQL-Datenbankdefinition finden Sie in diesem Artikel . |
|
SQLDatabase |
Die Öffentliche Definitionsantwort der SQL-Datenbank. |
|
SQLDatabase |
SQL-Datenbankdefinitionsteilobjekt. |
ErrorParameter
Ein strukturierter Parameter, der zusätzlichen computerlesbaren Kontext zu einem Fehler bereitstellt.
| Name | Typ | Beschreibung |
|---|---|---|
| message |
string |
Eine lesbare Beschreibung der Bedeutung des Parameters. |
| name |
string |
Die Parameterkennung. |
| value |
string |
Der übergebene Wert |
ErrorRelatedResource
Das Fehlerbezogene Ressourcendetails-Objekt.
| Name | Typ | Beschreibung |
|---|---|---|
| resourceId |
string |
Die Ressourcen-ID, die an dem Fehler beteiligt ist. |
| resourceType |
string |
Der Typ der Ressource, die an dem Fehler beteiligt ist. |
ErrorResponse
Die Fehlerantwort.
| Name | Typ | Beschreibung |
|---|---|---|
| errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
| isRetriable |
boolean |
Wenn true, kann die Anforderung wiederholt werden. Verwenden Sie den |
| message |
string |
Eine lesbare Darstellung des Fehlers. |
| moreDetails |
Liste der zusätzlichen Fehlerdetails. |
|
| parameters |
Strukturierte Parameter, die zusätzlichen maschinenlesbaren Kontext zu dem Fehler bereitstellen. |
|
| relatedResource |
Die fehlerbezogenen Ressourcendetails. |
|
| requestId |
string (uuid) |
ID der Anforderung, die dem Fehler zugeordnet ist. |
ErrorResponseDetails
Die Fehlerantwortdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
| message |
string |
Eine lesbare Darstellung des Fehlers. |
| parameters |
Strukturierte Parameter, die zusätzlichen maschinenlesbaren Kontext zu dem Fehler bereitstellen. |
|
| relatedResource |
Die fehlerbezogenen Ressourcendetails. |
PayloadType
Der Typ der Definitionsteilnutzlast. Zusätzliche Nutzlasttypen können im Laufe der Zeit hinzugefügt werden.
| Wert | Beschreibung |
|---|---|
| InlineBase64 |
Inlinebasis 64. |
SQLDatabaseDefinition
Das öffentliche SQL-Datenbankdefinitionsobjekt. Weitere Informationen zur Struktur der SQL-Datenbankdefinition finden Sie in diesem Artikel .
| Name | Typ | Beschreibung |
|---|---|---|
| format |
string |
Das Format der SQL-Datenbankdefinition. Unterstütztes Format: |
| parts |
Eine Liste der Definitionsteile. |
SQLDatabaseDefinitionResponse
Die Öffentliche Definitionsantwort der SQL-Datenbank.
| Name | Typ | Beschreibung |
|---|---|---|
| definition |
Das öffentliche SQL-Datenbankdefinitionsobjekt. Weitere Informationen zur Struktur der SQL-Datenbankdefinition finden Sie in diesem Artikel . |
SQLDatabasePublicDefinitionPart
SQL-Datenbankdefinitionsteilobjekt.
| Name | Typ | Beschreibung |
|---|---|---|
| path |
string |
Der Teilpfad der öffentlichen SQL-Datenbankdefinition. Unterstützte SQL-Datenbankinhaltserweiterungen: |
| payload |
string |
Die Nutzlast des öffentlichen SQL-Datenbankdefinitionsteils. |
| payloadType |
Der Nutzlasttyp. |