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
warehouseId
path True

string (uuid)

Varaston tunnus.

workspaceId
path True

string (uuid)

Työtilan tunnus.

updateMetadata
query

boolean

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

Pyynnön leipäteksti

Nimi Pakollinen Tyyppi Kuvaus
definition True

WarehouseDefinition

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

  • 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 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
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.

UpdateWarehouseDefinitionRequest

Päivitä varaston julkisen määritelmän pyynnön tiedot.

WarehouseDefinition

Varaston julkisen määrityksen objekti. Katso tästä artikkelista lisätietoja varastomääritelmän rakenteesta.

WarehouseDefinitionPart

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

UpdateWarehouseDefinitionRequest

Päivitä varaston julkisen määritelmän pyynnön tiedot.

Nimi Tyyppi Kuvaus
definition

WarehouseDefinition

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: dacpac ja sqlproj. Jos muotoa ei ole annettu, sqlproj käytetään kohdetta .

parts

WarehouseDefinitionPart[]

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

PayloadType

Hyötykuorman tyyppi.