Items - Refresh Sql Endpoint Metadata

Služba:: SQLEndpoint

Verze rozhraní API:: v1

Aktualizuje všechny tabulky v rámci koncového bodu analýzy SQL.
Toto rozhraní API podporuje dlouhotrvajících operací (LRO).

Permissions

Volající musí mít roli přispěvatele nebo vyšší.

Požadované delegovaná rozsahy

Item.ReadWrite.All

Podporované identity v Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identity	Support
User	Yes
Hlavní služba a Spravované identity	Yes

Interface

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
sqlEndpointId	path	True	string (uuid)	ID koncového bodu SQL Analytics.
workspaceId	path	True	string (uuid)	Identifikátor pracovního prostoru.

Text požadavku

Name	Typ	Description
recreateTables	boolean	Pokud je tato vlastnost nastavená na hodnotu true, dá systému pokyn, aby během procesu aktualizace zahodil a znovu vytvořil všechny tabulky v koncovém bodu sql Analytics. Tuto možnost použijte, pokud potřebujete plně znovu sestavit tabulky z jejich zdrojových definic, například vyřešit nekonzistence nebo zajistit čistou aktualizaci. Výchozí hodnota je false.
timeout	Duration	Doba trvání požadavku před uplynutím časového limitu. Výchozí hodnota je 15 minut.

Odpovědi

Name	Typ	Description
200 OK	TableSyncStatuses	Žádost byla úspěšně dokončena.
202 Accepted		Žádost byla přijata a probíhá aktualizace tabulky SQL Analytics. Hlavičky Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Běžné kódy chyb: ItemNotFound – Požadovaná položka nebyla nalezena.

Name

Typ

Description

200 OK

TableSyncStatuses

Žádost byla úspěšně dokončena.

202 Accepted

Žádost byla přijata a probíhá aktualizace tabulky SQL Analytics.

Hlavičky

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Běžné kódy chyb:

ItemNotFound – Požadovaná položka nebyla nalezena.

Příklady

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

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 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"
    }
  ]
}

Definice

Name	Description
Duration	Doba trvání.
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.
SqlEndpointRefreshMetadataRequest	Aktualizujte datovou část požadavku koncového bodu SQL analaytics.
SyncStatus	Stav operace synchronizace. V průběhu času je možné přidat další typy SyncStatus.
TableSyncStatus	Objekt stavu synchronizace tabulky.
TableSyncStatuses	Seznam stavů synchronizace tabulek.
TimeUnit	Jednotka času pro dobu trvání. Další typy doby trvání mohou být přidány v průběhu času.

Duration

Objekt

Doba trvání.

Name	Typ	Description
timeUnit	TimeUnit	Jednotka času pro dobu trvání. Další typy doby trvání mohou být přidány v průběhu času.
value	number	Počet časových jednotek v době trvání.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou

SqlEndpointRefreshMetadataRequest

Objekt

Aktualizujte datovou část požadavku koncového bodu SQL analaytics.

Name	Typ	Description
recreateTables	boolean	Pokud je tato vlastnost nastavená na hodnotu true, dá systému pokyn, aby během procesu aktualizace zahodil a znovu vytvořil všechny tabulky v koncovém bodu sql Analytics. Tuto možnost použijte, pokud potřebujete plně znovu sestavit tabulky z jejich zdrojových definic, například vyřešit nekonzistence nebo zajistit čistou aktualizaci. Výchozí hodnota je false.
timeout	Duration	Doba trvání požadavku před uplynutím časového limitu. Výchozí hodnota je 15 minut.

SyncStatus

Výčet

Stav operace synchronizace. V průběhu času je možné přidat další typy SyncStatus.

Hodnota	Description
Success	Označuje úspěch.
Failure	Označuje selhání.
NotRun	Označuje, že operace nebyla spuštěna.

TableSyncStatus

Objekt

Objekt stavu synchronizace tabulky.

Name	Typ	Description
endDateTime	string (date-time)	Datum a čas dokončení synchronizace tabulky ve standardu UTC pomocí formátu RRRR-MM-DDTHH:mm:ssZ.
error	ErrorResponseDetails	Podrobnosti odpovědi na chybu
lastSuccessfulSyncDateTime	string (date-time)	Datum a čas úspěšné synchronizace tabulky ve formátu UTC pomocí formátu RRRR-MM-DDTHH:mm:ssZ.
startDateTime	string (date-time)	Datum a čas spuštění synchronizace tabulky v UTC pomocí formátu RRRR-MM-DDTHH:mm:ssZ.
status	SyncStatus	Určuje, jestli se tabulka synchronizovala bez chyb.
tableName	string	Název tabulky, která se synchronizovala.

TableSyncStatuses

Objekt

Seznam stavů synchronizace tabulek.

Name	Typ	Description
value	TableSyncStatus[]	Seznam stavů synchronizace tabulek.

TimeUnit

Výčet

Jednotka času pro dobu trvání. Další typy doby trvání mohou být přidány v průběhu času.

Hodnota	Description
Seconds	Doba trvání v sekundách.
Minutes	Doba trvání v minutách.
Hours	Doba trvání v hodinách.
Days	Doba trvání ve dnech.

Sdílet prostřednictvím

Items - Refresh Sql Endpoint Metadata

Permissions

Požadované delegovaná rozsahy

Podporované identity v Microsoft Entra

Interface

Parametry identifikátoru URI

Text požadavku

Odpovědi

Příklady

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

Ukázkový požadavek

Ukázková odpověď

Definice

Duration

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

SqlEndpointRefreshMetadataRequest

SyncStatus

TableSyncStatus

TableSyncStatuses

TimeUnit