Items - Update SQL Database Definition

Ohittaa määritetyn SQL-tietokannan määrityksen.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

SQL-tietokannan määrityksen päivittäminen ei vaikuta sen luottamuksellisuustunnistetta.

Oikeudet

Soittajalla on oltava SQL-tietokannan luku- ja kirjoitusoikeudet .

Vaaditut delegoidut vaikutusalueet

SQLDatabase.ReadWrite.All tai Item.ReadWrite.All

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Käyttäjätiedot Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Kyllä

Liittymä

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-parametrit

Nimi Kohteessa Pakollinen Tyyppi Kuvaus
sqlDatabaseId
path True

string (uuid)

SQL-tietokannan tunnus.

workspaceId
path True

string (uuid)

Työtilan tunnus.

updateMetadata
query

boolean

Kun asetus on true ja SQL database.platform -tiedosto annetaan osana määritystä, kohteen metatiedot päivitetään käyttämällä SQL database.platform -tiedoston metatietoja.

Pyynnön leipäteksti

Nimi Pakollinen Tyyppi Kuvaus
definition True

SQLDatabaseDefinition

SQL-tietokannan julkinen määritysobjekti. Katso tästä artikkelista lisätietoja SQL-tietokannan määrityksen rakenteesta.

Vastaukset

Nimi Tyyppi Kuvaus
200 OK

Pyynnön valmistuttua.

202 Accepted

Pyyntö hyväksytty. Päivitysmääritys on meneillään.

Otsikot

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

ErrorResponse

Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään.

Otsikot

Retry-After: integer

Other Status Codes

ErrorResponse

Yleiset virhekoodit:

  • OperationNotSupportedForItem – Toimintoa ei tueta pyydetylle kohteelle.

  • VioittunutPayload – Annetut tiedot ovat vioittuneet.

Esimerkit

Update a SQL database public definition example

Mallipyyntö

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"
      }
    ]
  }
}

Mallivastaus

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

Määritelmät

Nimi Kuvaus
ErrorParameter

Jäsennetty parametri, joka antaa koneluettavaa lisäkontekstia virheestä.

ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.

ErrorResponse

Virhevastaus.

ErrorResponseDetails

Virheen vastauksen tiedot.

PayloadType

Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.

SQLDatabaseDefinition

SQL-tietokannan julkinen määritysobjekti. Katso tästä artikkelista lisätietoja SQL-tietokannan määrityksen rakenteesta.

SQLDatabasePublicDefinitionPart

SQL-tietokannan määritysosan objekti.

UpdateSQLDatabaseDefinitionRequest

Päivitä SQL-tietokannan julkisen määrityksen pyynnön tiedot.

ErrorParameter

Jäsennetty parametri, joka antaa koneluettavaa lisäkontekstia virheestä.

Nimi Tyyppi Kuvaus
message

string

Ihmisen luettavissa oleva kuvaus parametrin merkityksestä.

name

string

Parametritunniste.

value

string

Parametriarvo.

ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Kuvaus
resourceId

string

Virheestä liittyvä resurssitunnus.

resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Virhevastaus.

Nimi Tyyppi Kuvaus
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.

isRetriable

boolean

Kun arvo on tosi, pyyntöä voidaan yrittää uudelleen. Määritä viive vastausotsikon Retry-After avulla, jos se on käytettävissä.

message

string

Ihmisen luettavissa oleva esitys virheestä.

moreDetails

ErrorResponseDetails[]

Luettelo virheiden lisätiedoista.

parameters

ErrorParameter[]

Jäsennettyjä parametreja, jotka antavat koneluettavaa lisäkontekstia virheestä.

relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.

requestId

string (uuid)

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Virheen vastauksen tiedot.

Nimi Tyyppi Kuvaus
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.

message

string

Ihmisen luettavissa oleva esitys virheestä.

parameters

ErrorParameter[]

Jäsennettyjä parametreja, jotka antavat koneluettavaa lisäkontekstia virheestä.

relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.

PayloadType

Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.

Arvo Kuvaus
InlineBase64

Inline Base 64.

SQLDatabaseDefinition

SQL-tietokannan julkinen määritysobjekti. Katso tästä artikkelista lisätietoja SQL-tietokannan määrityksen rakenteesta.

Nimi Tyyppi Kuvaus
format

string

SQL-tietokannan määrityksen muoto. Tuettu muoto: dacpac ja sqlproj. Jos muotoa ei ole annettu, dacpac käytetään kohdetta .

parts

SQLDatabasePublicDefinitionPart[]

Luettelo määritysosista.

SQLDatabasePublicDefinitionPart

SQL-tietokannan määritysosan objekti.

Nimi Tyyppi Kuvaus
path

string

SQL-tietokannan julkisen määrityksen osan polku. Tuetut SQL-tietokannan sisältölaajennukset: .dacpacdacpac for format; .sqlproj, .sql for sqlproj format.

payload

string

SQL-tietokannan julkisen määrityksen osakuormitus.

payloadType

PayloadType

Hyötykuorman tyyppi.

UpdateSQLDatabaseDefinitionRequest

Päivitä SQL-tietokannan julkisen määrityksen pyynnön tiedot.

Nimi Tyyppi Kuvaus
definition

SQLDatabaseDefinition

SQL-tietokannan julkinen määritysobjekti. Katso tästä artikkelista lisätietoja SQL-tietokannan määrityksen rakenteesta.