Items - Refresh Sql Endpoint Metadata

Palvelu:

SQLEndpoint

Ohjelmointirajapinnan versio:

v1

Päivittää kaikki SQL-analytiikan päätepisteen taulukot.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Permissions

Kutsujalla on oltava osallistujan tai suurempi työtilarooli.

Vaaditut delegoidut vaikutusalueet

Item.ReadWrite.All

Microsoft Entran tukemat käyttäjätiedot

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

Identity	Support
User	Yes
palvelun päänimen ja Hallittujen käyttäjätietojen	Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlEndpoints/{sqlEndpointId}/refreshMetadata

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
sqlEndpointId	path	True	string (uuid)	SQL-analytiikan päätepisteen tunnus.
workspaceId	path	True	string (uuid)	Työtilan tunnus.

Pyynnön leipäteksti

Nimi	Tyyppi	Description
recreateTables	boolean	Kun asetus on true, tämä ominaisuus ohjaa järjestelmän pudottamaan kaikki taulukot ja luomaan ne uudelleen SQL-analytiikan päätepisteessä päivitysprosessin aikana. Käytä tätä asetusta, jos sinun on luotava taulukot kokonaan uudelleen niiden lähdemääritelmästä, esimerkiksi epäyhtenäisyyksien ratkaisemiseksi tai siistin päivityksen varmistamiseksi. Oletusarvo on epätosi.
timeout	Duration	Pyynnön kesto ennen aikakatkaisua. Oletusarvo on 15 minuuttia.

Vastaukset

Nimi	Tyyppi	Description
200 OK	TableSyncStatuses	Pyynnön valmistuttua.
202 Accepted		Pyyntö hyväksytty, SQL Analytics -taulukon päivitys meneillään. Otsikot Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: ItemNotFound – Pyydettyä kohdetta ei löytynyt.

Esimerkit

Refresh all tables for a specified SQL analytics endpoint in a workspace

Mallipyyntö

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlEndpoints/5b218778-e7a5-4d73-8187-f10824047715/refreshMetadata

Mallivastaus

Tilakoodi:

200

{
  "value": [
    {
      "tableName": "Table 1",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:36:54.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2025-08-08T10:36:54.9651741Z"
    },
    {
      "tableName": "Table 2",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:43:02.5329616Z",
      "status": "Failure",
      "error": {
        "errorCode": "AdalRetryException",
        "message": "Couldn't run query. There is a problem with the Microsoft Entra ID token. Have the warehouse owner log in again. If they're unavailable, use the takeover feature."
      },
      "lastSuccessfulSyncDateTime": "2025-08-07T10:44:27.2632648Z"
    },
    {
      "tableName": "Table 3",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:36:59.9183509Z",
      "status": "NotRun",
      "lastSuccessfulSyncDateTime": "2025-08-06T08:32:53.3890146Z"
    }
  ]
}

Määritelmät

Nimi	Description
Duration	Kesto.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
SqlEndpointRefreshMetadataRequest	Päivitä SQL-analaytics-päätepistepyynnön tiedot.
SyncStatus	Synkronointitoiminnon tila. Lisää SyncStatus-tyyppejä voidaan lisätä ajan mittaan.
TableSyncStatus	Taulukon synkronoinnin tilaobjekti.
TableSyncStatuses	Luettelo taulukon synkronoinnin tiluksista.
TimeUnit	Keston aikayksikkö. Muita kestotyyppejä voidaan lisätä ajan kuluessa.

Duration

Kohde

Kesto.

Nimi	Tyyppi	Description
timeUnit	TimeUnit	Keston aikayksikkö. Muita kestotyyppejä voidaan lisätä ajan kuluessa.
value	number	timeUnits-aikaUnits-määrä keston aikana.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Description
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

Virhevastaus.

Nimi	Tyyppi	Description
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ä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

Virheen vastauksen tiedot.

Nimi	Tyyppi	Description
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ä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

SqlEndpointRefreshMetadataRequest

Kohde

Päivitä SQL-analaytics-päätepistepyynnön tiedot.

Nimi	Tyyppi	Description
recreateTables	boolean	Kun asetus on true, tämä ominaisuus ohjaa järjestelmän pudottamaan kaikki taulukot ja luomaan ne uudelleen SQL-analytiikan päätepisteessä päivitysprosessin aikana. Käytä tätä asetusta, jos sinun on luotava taulukot kokonaan uudelleen niiden lähdemääritelmästä, esimerkiksi epäyhtenäisyyksien ratkaisemiseksi tai siistin päivityksen varmistamiseksi. Oletusarvo on epätosi.
timeout	Duration	Pyynnön kesto ennen aikakatkaisua. Oletusarvo on 15 minuuttia.

SyncStatus

Luettelointi

Synkronointitoiminnon tila. Lisää SyncStatus-tyyppejä voidaan lisätä ajan mittaan.

Arvo	Description
Success	Ilmaisee onnistumisen.
Failure	Ilmaisee virheen.
NotRun	Ilmaisee, että toimintoa ei suorittanut.

TableSyncStatus

Kohde

Taulukon synkronoinnin tilaobjekti.

Nimi	Tyyppi	Description
endDateTime	string (date-time)	Päivämäärä ja aika, kun taulukon synkronointi suoritettiin UTC-muodossa VVVV-KK-PPTH:mm:ssZ.
error	ErrorResponseDetails	Virhevastauksen tiedot
lastSuccessfulSyncDateTime	string (date-time)	Päivämäärä ja kellonaika, jolloin taulukon synkronointi onnistui UTC-muodossa VVVV-KK-PPTHH:mm:ssZ.
startDateTime	string (date-time)	Päivämäärä ja kellonaika, jolloin taulukon synkronointi alkoi UTC-muodossa VVVV-KK-PPTHH:mm:ssZ.
status	SyncStatus	Onko taulukko synkronoitu ilman virheitä.
tableName	string	Synkronoidun taulukon nimi.

TableSyncStatuses

Kohde

Luettelo taulukon synkronoinnin tiluksista.

Nimi	Tyyppi	Description
value	TableSyncStatus[]	Luettelo taulukon synkronoinnin tiluksista.

TimeUnit

Luettelointi

Keston aikayksikkö. Muita kestotyyppejä voidaan lisätä ajan kuluessa.

Arvo	Description
Seconds	Kesto sekunteina.
Minutes	Kesto minuutteina.
Hours	Kesto tunteina.
Days	Kesto päivinä.