Items - Update Warehouse Definition
Ohittaa määritetyn varaston määrityksen.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.
Varaston määrityksen päivittäminen ei vaikuta sen luottamuksellisuustunnistetta.
Permissions
Soittajalla on oltava varaston luku- ja kirjoitusoikeudet .
Vaaditut delegoidut vaikutusalueet
Warehouse.ReadWrite.All tai Item.ReadWrite.All
tuettujen käyttäjätietojen Microsoft Entra
Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft identities.
| Identity | Tuki |
|---|---|
| Käyttäjä | Yes |
| palvelun päänimen ja Hallittujen käyttäjätietojen | Yes |
Liittymä
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-parametrit
| Nimi | Kohteessa | Pakollinen | Tyyppi | Kuvaus |
|---|---|---|---|---|
|
warehouse
|
path | True |
string (uuid) |
Varaston tunnus. |
|
workspace
|
path | True |
string (uuid) |
Työtilan tunnus. |
|
update
|
query |
boolean |
Kun asetuksena |
Pyynnön leipäteksti
| Nimi | Pakollinen | Tyyppi | Kuvaus |
|---|---|---|---|
| definition | True |
Varaston julkisen määrityksen objekti. Katso tästä artikkelista lisätietoja varastomääritelmän 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 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
Mallipyyntö
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"
}
]
}
}
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
Update a warehouse public definition in SQL project format example
Mallipyyntö
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"
}
]
}
}
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. |
|
Update |
Päivitä varaston julkisen määritelmän pyynnön tiedot. |
|
Warehouse |
Varaston julkisen määrityksen objekti. Katso tästä artikkelista lisätietoja varastomääritelmän rakenteesta. |
|
Warehouse |
Varaston määritysosan objekti. |
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. |
UpdateWarehouseDefinitionRequest
Päivitä varaston julkisen määritelmän pyynnön tiedot.
| Nimi | Tyyppi | Kuvaus |
|---|---|---|
| definition |
Varaston julkisen määrityksen objekti. Katso tästä artikkelista lisätietoja varastomääritelmän rakenteesta. |
WarehouseDefinition
Varaston julkisen määrityksen objekti. Katso tästä artikkelista lisätietoja varastomääritelmän rakenteesta.
| Nimi | Tyyppi | Kuvaus |
|---|---|---|
| format |
string |
Varaston määrityksen muoto. Tuetut muodot: |
| parts |
Luettelo määritysosista. |
WarehouseDefinitionPart
Varaston määritysosan objekti.
| Nimi | Tyyppi | Kuvaus |
|---|---|---|
| path |
string |
Varaston julkisen määritelmän osan polku. |
| payload |
string |
Varaston julkisen määritelmän osan hyötykuorma. |
| payloadType |
Hyötykuorman tyyppi. |