Items - Update Warehouse Definition
Overstyrer definisjonen for det angitte lageret.
Denne API-en støtter langvarige operasjoner (LRO).
Oppdatering av lagerdefinisjonen påvirker ikke følsomhetsetiketten.
Permissions
Innringeren må ha lese- og skrivetillatelser for lageret.
Nødvendige delegerte omfang
Warehouse.ReadWrite.All eller Item.ReadWrite.All
Microsoft Entra støttede identiteter
Denne API-en støtter Microsoft identiteter oppført i denne delen.
| Identity | Støtte |
|---|---|
| Bruker | Ja |
| tjenestekontohaver og administrerte identiteter | Ja |
Grensesnitt
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/warehouses/{warehouseId}/updateDefinition
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/warehouses/{warehouseId}/updateDefinition?updateMetadata={updateMetadata}
URI-parametere
| Name | I | Obligatorisk | Type | Beskrivelse |
|---|---|---|---|---|
|
warehouse
|
path | True |
string (uuid) |
Lager-ID-en. |
|
workspace
|
path | True |
string (uuid) |
Arbeidsområde-ID-en. |
|
update
|
query |
boolean |
Når den er satt til |
Brødtekst for forespørsel
| Name | Obligatorisk | Type | Beskrivelse |
|---|---|---|---|
| definition | True |
Det offentlige definisjonsobjektet for lageret. Se denne artikkelen for mer informasjon om strukturen i lagerdefinisjonen. |
Svar
| Name | Type | Beskrivelse |
|---|---|---|
| 200 OK |
Forespørselen er fullført. |
|
| 202 Accepted |
Forespørselen er godtatt. Oppdateringsdefinisjonen pågår. Overskrifter
|
|
| 429 Too Many Requests |
Grensen for tjenestesats ble overskredet. Serveren returnerer en Overskrifter Retry-After: integer |
|
| Other Status Codes |
Vanlige feilkoder:
|
Eksempler
| Update a warehouse public definition in DACPAC format example |
| Update a warehouse public definition in SQL project format example |
Update a warehouse public definition in DACPAC format example
Eksempelforespørsel
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehouses/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True
{
"definition": {
"format": "dacpac",
"parts": [
{
"path": "definition.dacpac",
"payload": "UEsDBBQAAAAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAEAAAAGRlZmluaXRpb24uZGFjcGFj",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "ewogICIkc2NoZW1hIjogImh0dHBzOi8vZGV2ZWxvcGVyLm1pY3Jvc29mdC5jb20vanNvbi1zY2hlbWFzL2ZhYnJpYy9naXRJbnRlZ3JhdGlvbi9wbGF0Zm9ybVByb3BlcnRpZXMvMi4wLjAvc2NoZW1hLmpzb24iLAogICJtZXRhZGF0YSI6IHsKICAgICJ0eXBlIjogIldhcmVob3VzZSIsCiAgICAiZGlzcGxheU5hbWUiOiAiV2FyZWhvdXNlXzEiCiAgfSwKICAiY29uZmlnIjogewogICAgInZlcnNpb24iOiAiMi4wIiwKICAgICJsb2dpY2FsSWQiOiAiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDAwIgogIH0KfQ==",
"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
Update a warehouse public definition in SQL project format example
Eksempelforespørsel
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/warehouses/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True
{
"definition": {
"format": "sqlproj",
"parts": [
{
"path": "sqldw.sqlproj",
"payload": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxQcm9qZWN0IERlZmF1bHRUYXJnZXRzPSJCdWlsZCI+DQogIDxTZGs+TWljcm9zb2Z0LkJ1aWxkLlNxbC9TZGsNCiAgPC9TZGs+DQo8L1Byb2plY3Q+",
"payloadType": "InlineBase64"
},
{
"path": "dbo/Tables/Table1.sql",
"payload": "Q1JFQVRFIFRBQkxFIFtkYm9dLltUYWJsZTFdIChbSWRdIElOVCBOT1QgTlVMTCwgW05hbWVdIE5WQVJDSEFSKDEwMCkp",
"payloadType": "InlineBase64"
},
{
"path": ".sharedqueries/query.sql",
"payload": "U0VMRUNUIFtJZF0sIFtOYW1lXSBGUk9NIFtkYm9dLltUYWJsZTFd",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "ewogICIkc2NoZW1hIjogImh0dHBzOi8vZGV2ZWxvcGVyLm1pY3Jvc29mdC5jb20vanNvbi1zY2hlbWFzL2ZhYnJpYy9naXRJbnRlZ3JhdGlvbi9wbGF0Zm9ybVByb3BlcnRpZXMvMi4wLjAvc2NoZW1hLmpzb24iLAogICJtZXRhZGF0YSI6IHsKICAgICJ0eXBlIjogIldhcmVob3VzZSIsCiAgICAiZGlzcGxheU5hbWUiOiAiV2FyZWhvdXNlXzEiCiAgfSwKICAiY29uZmlnIjogewogICAgInZlcnNpb24iOiAiMi4wIiwKICAgICJsb2dpY2FsSWQiOiAiMDAwMDAwMDAtMDAwMC0wMDAwLTAwMDAtMDAwMDAwMDAwMDAwIgogIH0KfQ==",
"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 |
|---|---|
|
Error |
En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil. |
|
Error |
Objektet for feilrelaterte ressursdetaljer. |
|
Error |
Feilsvaret. |
|
Error |
Feilsvardetaljene. |
|
Payload |
Typen nyttelast for definisjonsdelen. Flere nyttelasttyper kan legges til over tid. |
|
Update |
Oppdater nyttelast for offentlig definisjon for lagerdefinisjon. |
|
Warehouse |
Det offentlige definisjonsobjektet for lageret. Se denne artikkelen for mer informasjon om strukturen i lagerdefinisjonen. |
|
Warehouse |
Lagerdefinisjonsdelobjekt. |
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.
|
| message |
string |
En menneskelig lesbar representasjon av feilen. |
| moreDetails |
Liste over flere feildetaljer. |
|
| parameters |
Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen. |
|
| relatedResource |
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 |
Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen. |
|
| relatedResource |
Feilrelaterte ressursdetaljer. |
PayloadType
Typen nyttelast for definisjonsdelen. Flere nyttelasttyper kan legges til over tid.
| Verdi | Beskrivelse |
|---|---|
| InlineBase64 |
Innebygd grunntall 64. |
UpdateWarehouseDefinitionRequest
Oppdater nyttelast for offentlig definisjon for lagerdefinisjon.
| Name | Type | Beskrivelse |
|---|---|---|
| definition |
Det offentlige definisjonsobjektet for lageret. Se denne artikkelen for mer informasjon om strukturen i lagerdefinisjonen. |
WarehouseDefinition
Det offentlige definisjonsobjektet for lageret. Se denne artikkelen for mer informasjon om strukturen i lagerdefinisjonen.
| Name | Type | Beskrivelse |
|---|---|---|
| format |
string |
Formatet for lagerdefinisjonen. Støttede formater: |
| parts |
En liste over definisjonsdeler. |
WarehouseDefinitionPart
Lagerdefinisjonsdelobjekt.
| Name | Type | Beskrivelse |
|---|---|---|
| path |
string |
Den offentlige definisjonsdelbanen for lageret. |
| payload |
string |
Lagerets offentlige definisjonsdel nyttelast. |
| payloadType |
Nyttelasttypen. |