Items - Refresh Sql Endpoint Metadata

Szolgáltatás:

SQLEndpoint

API verzió:

v1

Frissíti az SQL Analytics-végponton belüli összes táblát.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

Permissions

A hívónak közreműködői vagy magasabb munkaterületi szerepkört kell tartalmaznia.

Kötelező delegált hatókörök

Item.ReadWrite.All

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Identity	Support
User	Yes
szolgáltatás-princípium és felügyelt identitások	Yes

Interface

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

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
sqlEndpointId	path	True	string (uuid)	Az SQL Analytics végpontazonosítója.
workspaceId	path	True	string (uuid)	A munkaterület azonosítója.

Kérő Testület

Név	Típus	Leírás
recreateTables	boolean	Ha igaz értékre van állítva, ez a tulajdonság arra utasítja a rendszert, hogy a frissítési folyamat során ejtse le és hozza létre újra az SQL Analytics-végpont összes tábláját. Ezt a lehetőséget akkor használhatja, ha teljesen újra kell építenie a táblákat a forrásdefiníciókból, például az inkonzisztenciák feloldásához vagy a tiszta frissítés biztosításához. Az alapértelmezett érték hamis.
timeout	Duration	A kérelem időtartama az időtúllépés előtt. Az alapértelmezett érték 15 perc.

Válaszok

Név	Típus	Leírás
200 OK	TableSyncStatuses	A kérés sikeresen befejeződött.
202 Accepted		A kérelem elfogadva, az SQL Analytics-tábla frissítése folyamatban van. Fejlécek Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Túllépte a szolgáltatási sebesség korlátját. A kiszolgáló egy Retry-After fejlécet ad vissza másodpercek alatt, amely jelzi, hogy az ügyfélnek mennyi ideig kell várnia a további kérések elküldése előtt. Fejlécek Retry-After: integer
Other Status Codes	ErrorResponse	Gyakori hibakódok: ItemNotFound – A kért elem nem található.

Példák

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

Mintakérés

HTTP

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

Mintaválasz

Állapotkó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"
    }
  ]
}

Meghatározások

Név	Leírás
Duration	Időtartam.
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
SqlEndpointRefreshMetadataRequest	Frissítse az SQL analaytics végpontkérelem hasznos adatait.
SyncStatus	A szinkronizálási művelet állapota. Idővel további SyncStatus-típusok is hozzáadhatók.
TableSyncStatus	Táblaszinkronizálási állapotobjektum.
TableSyncStatuses	A táblaszinkronizálási állapotok listája.
TimeUnit	Az időtartam időegysége. Idővel további időtartamtípusok is hozzáadhatók.

Duration

Tárgy

Időtartam.

Név	Típus	Leírás
timeUnit	TimeUnit	Az időtartam időegysége. Idővel további időtartamtípusok is hozzáadhatók.
value	number	Az időtartam időegységeinek száma.

ErrorRelatedResource

Tárgy

A hibával kapcsolatos erőforrás-részletek objektum.

Név	Típus	Leírás
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Tárgy

A hibaválasz.

Név	Típus	Leírás
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string (uuid)	A hibához társított kérés azonosítója.

ErrorResponseDetails

Tárgy

A hibaválasz részletei.

Név	Típus	Leírás
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

SqlEndpointRefreshMetadataRequest

Tárgy

Frissítse az SQL analaytics végpontkérelem hasznos adatait.

Név	Típus	Leírás
recreateTables	boolean	Ha igaz értékre van állítva, ez a tulajdonság arra utasítja a rendszert, hogy a frissítési folyamat során ejtse le és hozza létre újra az SQL Analytics-végpont összes tábláját. Ezt a lehetőséget akkor használhatja, ha teljesen újra kell építenie a táblákat a forrásdefiníciókból, például az inkonzisztenciák feloldásához vagy a tiszta frissítés biztosításához. Az alapértelmezett érték hamis.
timeout	Duration	A kérelem időtartama az időtúllépés előtt. Az alapértelmezett érték 15 perc.

SyncStatus

Felsorolás

A szinkronizálási művelet állapota. Idővel további SyncStatus-típusok is hozzáadhatók.

Érték	Leírás
Success	Sikerességet jelez.
Failure	Hibát jelez.
NotRun	Azt jelzi, hogy a művelet nem futott.

TableSyncStatus

Tárgy

Táblaszinkronizálási állapotobjektum.

Név	Típus	Leírás
endDateTime	string (date-time)	Az a dátum és idő, amikor a tábla szinkronizálása UTC-ben befejeződött, YYYY-MM-DDTHH:mm:ssZ formátumban.
error	ErrorResponseDetails	A hibaválasz részletei
lastSuccessfulSyncDateTime	string (date-time)	A táblaszinkronizálás sikerességének dátuma és időpontja UTC-ben, YYYY-MM-DDTHH:mm:ssZ formátumban.
startDateTime	string (date-time)	Az a dátum és idő, amikor a tábla szinkronizálása UTC-ben kezdődött, YYYY-MM-DDTHH:mm:ssZ formátumban.
status	SyncStatus	Azt jelzi, hogy a tábla hiba nélkül szinkronizálva van-e.
tableName	string	A szinkronizált tábla neve.

TableSyncStatuses

Tárgy

A táblaszinkronizálási állapotok listája.

Név	Típus	Leírás
value	TableSyncStatus[]	A táblaszinkronizálási állapotok listája.

TimeUnit

Felsorolás

Az időtartam időegysége. Idővel további időtartamtípusok is hozzáadhatók.

Érték	Leírás
Seconds	Időtartam másodpercben.
Minutes	Időtartam percekben.
Hours	Időtartam órákban.
Days	Időtartam napokban.