Items - Refresh Sql Endpoint Metadata

Služba:

SQLEndpoint

Verzia rozhrania API:

v1

Obnoví všetky tabuľky v rámci koncového bodu analýzy SQL.
Toto rozhranie API podporuje dlhotrvajúce operácie (LRO).

Permissions

Volajúci musí mať rolu prispievateľa alebo vyššiu rolu pracovného priestoru.

Povinné delegované rozsahy

Item.ReadWrite.All

Podporované identity v aplikácii Microsoft Entra

Toto rozhranie API podporuje identity Microsoft uvedené v tejto časti.

Identity	Support
User	Yes
Objekt služby a spravované identity	Yes

Interface

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

Parametre URI

Name	V	Povinné	Typ	Description
sqlEndpointId	path	True	string (uuid)	ID koncového bodu analýzy SQL.
workspaceId	path	True	string (uuid)	ID pracovného priestoru.

Text požiadavky

Name	Typ	Description
timeout	Duration	Trvanie žiadosti pred uplynutím časového limitu. Predvolená hodnota je 15 minút.

Odpovede

Name	Typ	Description
200 OK	TableSyncStatuses	Požiadavka sa úspešne dokončila.
202 Accepted		Prebieha obnovenie tabuľky s analýzou SQL. Hlavičky Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Bežné kódy chýb: ItemNotFound – požadovaná položka sa nenašla.

Príklady

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

Vzorová požiadavka

HTTP

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

Vzorová odpoveď

Kód stavu:

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

Definície

Name	Description
Duration	Trvanie.
ErrorRelatedResource	Objekt s podrobnosťami o zdroji súvisiacej s chybou.
ErrorResponse	Odpoveď na chybu.
ErrorResponseDetails	Podrobnosti o chybovej odpovedi.
SqlEndpointRefreshMetadataRequest	Obnoviť údajovú časť požiadavky koncového bodu SQL na analaytiku.
SyncStatus	Stav operácie synchronizácie. V priebehu času je možné pridať ďalšie typy synchrónnej štatistiky.
TableSyncStatus	Objekt stavu synchronizácie tabuľky.
TableSyncStatuses	Zoznam stavov synchronizácie tabuliek.
TimeUnit	Jednotka času trvania. V priebehu času je možné pridať ďalšie typy trvania.

Duration

Object

Trvanie.

Name	Typ	Description
timeUnit	TimeUnit	Jednotka času trvania. V priebehu času je možné pridať ďalšie typy trvania.
value	number	Počet časových jednotiek v trvaní.

ErrorRelatedResource

Object

Objekt s podrobnosťami o zdroji súvisiacej s chybou.

Name	Typ	Description
resourceId	string	ID prostriedku, ktoré je súčasťou chyby.
resourceType	string	Typ prostriedku, ktorý je zapojený do chyby.

ErrorResponse

Object

Odpoveď na chybu.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
moreDetails	ErrorResponseDetails[]	Zoznam ďalších podrobností o chybe.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.
requestId	string	ID požiadavky súvisiacej s chybou.

ErrorResponseDetails

Object

Podrobnosti o chybovej odpovedi.

Name	Typ	Description
errorCode	string	Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message	string	Zobrazenie chyby čitateľné ľuďmi.
relatedResource	ErrorRelatedResource	Podrobnosti o zdrojoch súvisiacich s chybou.

SqlEndpointRefreshMetadataRequest

Object

Obnoviť údajovú časť požiadavky koncového bodu SQL na analaytiku.

Name	Typ	Description
timeout	Duration	Trvanie žiadosti pred uplynutím časového limitu. Predvolená hodnota je 15 minút.

SyncStatus

Enumerácia

Stav operácie synchronizácie. V priebehu času je možné pridať ďalšie typy synchrónnej štatistiky.

Hodnota	Description
Success	Označuje úspech.
Failure	Označuje zlyhanie.
NotRun	Znamená to, že operácia sa nespúšťla.

TableSyncStatus

Object

Objekt stavu synchronizácie tabuľky.

Name	Typ	Description
endDateTime	string (date-time)	Dátum a čas dokončenia synchronizácie tabuľky v UTC pomocou formátu RRRR-MM-DDTHH:mm:ssZ.
error	ErrorResponseDetails	Podrobnosti o chybovej odpovedi
lastSuccessfulSyncDateTime	string (date-time)	Dátum a čas úspešnej synchronizácie tabuľky v UTC pomocou formátu RRRR-MM-DDTHH:mm:ssZ.
startDateTime	string (date-time)	Dátum a čas začatia synchronizácie tabuľky v UTC pomocou formátu RRRR-MM-DDTHH:mm:ssZ.
status	SyncStatus	Určuje, či sa tabuľka synchronizovala bez chýb.
tableName	string	Názov tabuľky, ktorá sa synchronizovala.

TableSyncStatuses

Object

Zoznam stavov synchronizácie tabuliek.

Name	Typ	Description
value	TableSyncStatus[]	Zoznam stavov synchronizácie tabuliek.

TimeUnit

Enumerácia

Jednotka času trvania. V priebehu času je možné pridať ďalšie typy trvania.

Hodnota	Description
Seconds	Trvanie v sekundách.
Minutes	Trvanie v minútach.
Hours	Trvanie v hodinách.
Days	Trvanie v dňoch.