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 |
|---|---|---|---|---|
|
sql
|
path | True |
string (uuid) |
SQL-tietokannan tunnus. |
|
workspace
|
path | True |
string (uuid) |
Työtilan tunnus. |
|
update
|
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 |
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
|
|
| 429 Too Many Requests |
Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Otsikot Retry-After: integer |
|
| Other Status Codes |
Yleiset virhekoodit:
|
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 |
|---|---|
|
Error |
Jäsennetty parametri, joka antaa koneluettavaa lisäkontekstia virheestä. |
|
Error |
Virheeseen liittyvä resurssitieto-objekti. |
|
Error |
Virhevastaus. |
|
Error |
Virheen vastauksen tiedot. |
|
Payload |
Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa. |
|
SQLDatabase |
SQL-tietokannan julkinen määritysobjekti. Katso tästä artikkelista lisätietoja SQL-tietokannan määrityksen rakenteesta. |
|
SQLDatabase |
SQL-tietokannan määritysosan objekti. |
|
Update |
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 |
| message |
string |
Ihmisen luettavissa oleva esitys virheestä. |
| moreDetails |
Luettelo virheiden lisätiedoista. |
|
| parameters |
Jäsennettyjä parametreja, jotka antavat koneluettavaa lisäkontekstia virheestä. |
|
| relatedResource |
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 |
Jäsennettyjä parametreja, jotka antavat koneluettavaa lisäkontekstia virheestä. |
|
| relatedResource |
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: |
| parts |
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: |
| payload |
string |
SQL-tietokannan julkisen määrityksen osakuormitus. |
| payloadType |
Hyötykuorman tyyppi. |
UpdateSQLDatabaseDefinitionRequest
Päivitä SQL-tietokannan julkisen määrityksen pyynnön tiedot.
| Nimi | Tyyppi | Kuvaus |
|---|---|---|
| definition |
SQL-tietokannan julkinen määritysobjekti. Katso tästä artikkelista lisätietoja SQL-tietokannan määrityksen rakenteesta. |