Items - Refresh Sql Endpoint Metadata

Palvelu:: SQLEndpoint

Ohjelmointirajapinnan versio:: v1

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

Vain määritetyt taulukot päivitetään, kun tables ne on annettu pyynnön leipätekstissä. Kun tämä jätetään pois tai tyhjä, kaikki taulukot päivitetään.

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	Kuvaus
sqlEndpointId	path	True	string (uuid)	SQL-analytiikan päätepisteen tunnus.
workspaceId	path	True	string (uuid)	Työtilan tunnus.

Pyynnön leipäteksti

Nimi	Tyyppi	Kuvaus
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. Kun se yhdistetään :n kanssa `tables`, synkronoinnin tilan palautus koskee vain määritettyjä taulukoita. Oletusarvo on epätosi.
tables	TableDefinition[]	Kun tämä on annettu, se koskee päivitystä vain luettelossa olevissa taulukoissa. Kun tämä jätetään pois tai tyhjä, kaikki taulukot päivitetään. Jokainen merkintä määrittää rakenteen ja yhden tai useamman taulukon nimen, jotka päivitetään kyseisen rakenteen alla. Yksittäisessä pyynnössä synkronoitavien taulukoiden enimmäismäärä on 25. Taulukon tarkkuus riippuu siitä, onko SQL-päätepisteen pääkohde rakenne käytössä. Rakennetta käyttävissä kohteissa taulukot ratkaistaan soittajan tarjoaman rakenteen avulla. Jos kyseessä ovat kohteet, jotka eivät ole rakennetta käyttäviä, kaikki taulukot selvittää oletusrakenteen riippumatta kutsujan tarjoamasta rakennearvosta. Ei-oletusrakenteen alla olevat taulukot voidaan ratkaista, ja ne ilmoitetaan virheenä `DeltaTableNotFound` .
timeout	Duration	Pyynnön kesto ennen aikakatkaisua. Oletusarvo on 15 minuuttia.

Vastaukset

Nimi	Tyyppi	Kuvaus
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
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: ItemNotFound – Pyydettyä kohdetta ei löytynyt.

Esimerkit

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

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

Refresh selective tables with recreate tables for a specified SQL analytics endpoint in a workspace

Refresh selective tables with user defined schemas for a specified SQL analytics endpoint in a workspace

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"
    }
  ]
}

Refresh selective 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

{
  "tables": [
    {
      "schema": "dbo",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    },
    {
      "schema": "dbo",
      "tableNames": [
        "DailySummary"
      ]
    }
  ]
}

Mallivastaus

Tilakoodi:: 200

{
  "value": [
    {
      "tableName": "Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Failure",
      "error": {
        "errorCode": "DeltaTableNotFound",
        "message": "Delta table 'Tables\\OrderDetails\\_delta_log' not found."
      },
      "lastSuccessfulSyncDateTime": "2026-06-08T10:31:26.5329616Z"
    },
    {
      "tableName": "DailySummary",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:24.9183509Z",
      "status": "NotRun",
      "lastSuccessfulSyncDateTime": "2026-06-08T08:32:53.3890146Z"
    }
  ]
}

Refresh selective tables with recreate 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

{
  "recreateTables": true,
  "tables": [
    {
      "schema": "dbo",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    }
  ]
}

Mallivastaus

Tilakoodi:: 200

{
  "value": [
    {
      "tableName": "Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:26.5329616Z"
    }
  ]
}

Refresh selective tables with user defined schemas 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

{
  "tables": [
    {
      "schema": "sales",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    },
    {
      "schema": "analytics",
      "tableNames": [
        "DailySummary"
      ]
    }
  ]
}

Mallivastaus

Tilakoodi:: 200

{
  "value": [
    {
      "tableName": "sales.Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "sales.OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:26.5329616Z"
    },
    {
      "tableName": "analytics.DailySummary",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:24.9183509Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:24.9183509Z"
    }
  ]
}

Määritelmät

Nimi	Kuvaus
Duration	Kesto.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
SqlEndpointRefreshMetadataRequest	Pyynnön tiedot SQL-analytiikan päätepisteen päivittämistä varten.
SyncStatus	Synkronointitoiminnon tila. Lisää SyncStatus-tyyppejä voidaan lisätä ajan mittaan.
TableDefinition	Rakennepari ja taulukoiden nimet valikoivan päivityksen määrittämistä varten.
TableSyncStatus	Taulukon synkronoinnin tilaobjekti.
TableSyncStatuses	Luettelo taulukon synkronoinnin tiluksista.
TimeUnit	Keston aikayksikkö. Muita kestotyyppejä voidaan lisätä ajan kuluessa.

Duration

Kohde

Kesto.

Nimi	Tyyppi	Kuvaus
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	Kuvaus
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

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.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string (uuid)	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

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

SqlEndpointRefreshMetadataRequest

Kohde

Pyynnön tiedot SQL-analytiikan päätepisteen päivittämistä varten.

Nimi	Tyyppi	Kuvaus
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. Kun se yhdistetään :n kanssa `tables`, synkronoinnin tilan palautus koskee vain määritettyjä taulukoita. Oletusarvo on epätosi.
tables	TableDefinition[]	Kun tämä on annettu, se koskee päivitystä vain luettelossa olevissa taulukoissa. Kun tämä jätetään pois tai tyhjä, kaikki taulukot päivitetään. Jokainen merkintä määrittää rakenteen ja yhden tai useamman taulukon nimen, jotka päivitetään kyseisen rakenteen alla. Yksittäisessä pyynnössä synkronoitavien taulukoiden enimmäismäärä on 25. Taulukon tarkkuus riippuu siitä, onko SQL-päätepisteen pääkohde rakenne käytössä. Rakennetta käyttävissä kohteissa taulukot ratkaistaan soittajan tarjoaman rakenteen avulla. Jos kyseessä ovat kohteet, jotka eivät ole rakennetta käyttäviä, kaikki taulukot selvittää oletusrakenteen riippumatta kutsujan tarjoamasta rakennearvosta. Ei-oletusrakenteen alla olevat taulukot voidaan ratkaista, ja ne ilmoitetaan virheenä `DeltaTableNotFound` .
timeout	Duration	Pyynnön kesto ennen aikakatkaisua. Oletusarvo on 15 minuuttia.

SyncStatus

Luettelointi

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

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

TableDefinition

Kohde

Rakennepari ja taulukoiden nimet valikoivan päivityksen määrittämistä varten.

Nimi	Tyyppi	Kuvaus
schema	string minLength: 1 maxLength: 128	Taulukon tarkkuuden rakennenimi. Ei saa olla varattu järjestelmärakenne.
tableNames	string[] minLength: 1 maxLength: 128	Yhden tai useamman taulukon nimi, jotka päivitetään määritetyn rakenteen mukaisesti.

TableSyncStatus

Kohde

Taulukon synkronoinnin tilaobjekti.

Nimi	Tyyppi	Kuvaus
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. Rakennetta käyttävissä kohteissa taulukon nimessä on etuliitteenä rakenteen nimi (esimerkiksi "schema.tableName").

TableSyncStatuses

Kohde

Luettelo taulukon synkronoinnin tiluksista.

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

TimeUnit

Luettelointi

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

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