Items - Update SQL Database Definition

Overstyrer definisjonen for den angitte SQL-databasen.
Denne API-en støtter langvarige operasjoner (LRO).

Oppdatering av SQL-databasens definisjon påvirker ikke følsomhetsetiketten.

Tillatelser

Innringeren må ha lese- og skrivetillatelser for SQL-databasen.

Nødvendige delegerte omfang

SQLDatabase.ReadWrite.All eller Item.ReadWrite.All

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identity Kundestøtte
Bruker Ja
tjenestekontohaver og administrerte identiteter Ja

Grensesnitt

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

URI-parametere

Name I Obligatorisk Type Beskrivelse
sqlDatabaseId
path True

string (uuid)

SQL-database-ID-en.

workspaceId
path True

string (uuid)

Arbeidsområde-ID-en.

updateMetadata
query

boolean

Når den er satt til sann og SQL database.platform-filen er angitt som en del av definisjonen, oppdateres elementets metadata ved hjelp av metadataene i SQL database.platform-filen

Brødtekst for forespørsel

Name Obligatorisk Type Beskrivelse
definition True

SQLDatabaseDefinition

Det offentlige sql-databasedefinisjonsobjektet. Se denne artikkelen for mer informasjon om strukturen i SQL-databasedefinisjonen.

Svar

Name Type Beskrivelse
200 OK

Forespørselen er fullført.

202 Accepted

Forespørselen er godtatt. Oppdateringsdefinisjonen pågår.

Overskrifter

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

ErrorResponse

Grensen for tjenestesats ble overskredet. Serveren returnerer en Retry-After topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler.

Overskrifter

Retry-After: integer

Other Status Codes

ErrorResponse

Vanlige feilkoder:

  • OperationNotSupportedForItem – operasjonen støttes ikke for forespurt element.

  • CorruptedPayload – den angitte nyttelasten er skadet.

Eksempler

Update a SQL database public definition example

Eksempelforespørsel

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

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

Eksempelsvar

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

Definisjoner

Name Beskrivelse
ErrorParameter

En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil.

ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.

ErrorResponse

Feilsvaret.

ErrorResponseDetails

Feilsvardetaljene.

PayloadType

Typen nyttelast for definisjonsdelen. Flere nyttelasttyper kan legges til over tid.

SQLDatabaseDefinition

Det offentlige sql-databasedefinisjonsobjektet. Se denne artikkelen for mer informasjon om strukturen i SQL-databasedefinisjonen.

SQLDatabasePublicDefinitionPart

SQL-databasedefinisjonsdelobjekt.

UpdateSQLDatabaseDefinitionRequest

Oppdater nyttelast for den offentlige definisjonsforespørselen for SQL-database.

ErrorParameter

En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil.

Name Type Beskrivelse
message

string

En lesbar beskrivelse av parameterens betydning.

name

string

Parameteridentifikatoren.

value

string

Parameterverdien.

ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.

Name Type Beskrivelse
resourceId

string

Ressurs-ID-en som er involvert i feilen.

resourceType

string

Typen ressurs som er involvert i feilen.

ErrorResponse

Feilsvaret.

Name Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.

isRetriable

boolean

Når sann, kan forespørselen prøves på nytt. Retry-After Bruk svarhodet til å fastslå forsinkelsen, hvis tilgjengelig.

message

string

En menneskelig lesbar representasjon av feilen.

moreDetails

ErrorResponseDetails[]

Liste over flere feildetaljer.

parameters

ErrorParameter[]

Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen.

relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.

requestId

string (uuid)

ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Feilsvardetaljene.

Name Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.

message

string

En menneskelig lesbar representasjon av feilen.

parameters

ErrorParameter[]

Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen.

relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.

PayloadType

Typen nyttelast for definisjonsdelen. Flere nyttelasttyper kan legges til over tid.

Verdi Beskrivelse
InlineBase64

Innebygd grunntall 64.

SQLDatabaseDefinition

Det offentlige sql-databasedefinisjonsobjektet. Se denne artikkelen for mer informasjon om strukturen i SQL-databasedefinisjonen.

Name Type Beskrivelse
format

string

Formatet for SQL-databasedefinisjonen. Støttet format: dacpac og sqlproj. Hvis det ikke er angitt noe format, dacpac brukes.

parts

SQLDatabasePublicDefinitionPart[]

En liste over definisjonsdeler.

SQLDatabasePublicDefinitionPart

SQL-databasedefinisjonsdelobjekt.

Name Type Beskrivelse
path

string

Den offentlige definisjonsdelbanen for SQL-databasen. Støttede innholdsutvidelser for SQL-database: .dacpac for dacpac format; .sqlproj, .sql for sqlproj format.

payload

string

Den offentlige definisjonsdelen for SQL-databasen.

payloadType

PayloadType

Nyttelasttypen.

UpdateSQLDatabaseDefinitionRequest

Oppdater nyttelast for den offentlige definisjonsforespørselen for SQL-database.

Name Type Beskrivelse
definition

SQLDatabaseDefinition

Det offentlige sql-databasedefinisjonsobjektet. Se denne artikkelen for mer informasjon om strukturen i SQL-databasedefinisjonen.