Items - Refresh Sql Endpoint Metadata

Tjeneste:: SQLEndpoint

API-version:: v1

Opdaterer alle tabeller i et SQL Analytics-slutpunkt.
Denne API understøtter LRO-handlinger (Long Running Operations).

Permissions

Den, der ringer op, skal have rollen bidragyder eller en højere rolle i arbejdsområdet.

Påkrævede delegerede områder

Item.ReadWrite.All

Microsoft Entra-understøttede identiteter

Denne API understøtter de Microsoft -identiteter, der angivet i dette afsnit.

Identity	Support
User	Yes
tjenesteprincipal og administrerede identiteter	Yes

Interface

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

URI-parametre

Name	I	Påkrævet	Type	Beskrivelse
sqlEndpointId	path	True	string (uuid)	ID'et for SQL Analytics-slutpunktet.
workspaceId	path	True	string (uuid)	Arbejdsområde-id'et.

Brødtekst for anmodning

Name	Type	Beskrivelse
recreateTables	boolean	Når den er angivet til sand, får systemet besked om at slippe og genoprette alle tabeller på SQL Analytics-slutpunktet under opdateringsprocessen. Brug denne indstilling, hvis du har brug for at genopbygge tabeller fuldt ud fra deres kildedefinitioner, f.eks. for at løse uoverensstemmelser eller sikre en ren opdatering. Standardværdien er false.
timeout	Duration	Anmodningens varighed før timeout. Standardværdien er 15 minutter.

Svar

Name	Type	Beskrivelse
200 OK	TableSyncStatuses	Anmodningen blev fuldført.
202 Accepted		Anmodning accepteret. Opdatering af SQL-analysetabellen er i gang. Headere Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Almindelige fejlkoder: ItemNotFound – Det ønskede element blev ikke fundet.

Name

Type

Beskrivelse

200 OK

TableSyncStatuses

Anmodningen blev fuldført.

202 Accepted

Anmodning accepteret. Opdatering af SQL-analysetabellen er i gang.

Headere

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

Other Status Codes

ErrorResponse

Almindelige fejlkoder:

ItemNotFound – Det ønskede element blev ikke fundet.

Eksempler

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

Eksempelanmodning

HTTP

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

Eksempelsvar

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

Definitioner

Name	Beskrivelse
Duration	En varighed.
ErrorRelatedResource	Objektet med fejlrelaterede ressourceoplysninger.
ErrorResponse	Fejlsvaret.
ErrorResponseDetails	Oplysninger om fejlsvar.
SqlEndpointRefreshMetadataRequest	Opdater nyttedata for SQL-analaytics-slutpunktsanmodning.
SyncStatus	Status for synkroniseringshandlingen. Der kan tilføjes flere SyncStatus-typer over tid.
TableSyncStatus	Et statusobjekt til tabelsynkronisering.
TableSyncStatuses	En liste over status for tabelsynkronisering.
TimeUnit	Tidsenheden for varigheden. Der kan tilføjes flere varighedstyper over tid.

Duration

Objekt

En varighed.

Name	Type	Beskrivelse
timeUnit	TimeUnit	Tidsenheden for varigheden. Der kan tilføjes flere varighedstyper over tid.
value	number	Antallet af timeUnits i varigheden.

ErrorRelatedResource

Objekt

Objektet med fejlrelaterede ressourceoplysninger.

Name	Type	Beskrivelse
resourceId	string	Det ressource-id, der er involveret i fejlen.
resourceType	string	Typen af ressource, der er involveret i fejlen.

ErrorResponse

Objekt

Fejlsvaret.

Name	Type	Beskrivelse
errorCode	string	Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message	string	En menneskelig læsbar gengivelse af fejlen.
moreDetails	ErrorResponseDetails[]	Liste over yderligere oplysninger om fejl.
relatedResource	ErrorRelatedResource	De fejlrelaterede ressourceoplysninger.
requestId	string	Id'et for den anmodning, der er knyttet til fejlen.

ErrorResponseDetails

Objekt

Oplysninger om fejlsvar.

Name	Type	Beskrivelse
errorCode	string	Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message	string	En menneskelig læsbar gengivelse af fejlen.
relatedResource	ErrorRelatedResource	De fejlrelaterede ressourceoplysninger.

SqlEndpointRefreshMetadataRequest

Objekt

Opdater nyttedata for SQL-analaytics-slutpunktsanmodning.

Name	Type	Beskrivelse
recreateTables	boolean	Når den er angivet til sand, får systemet besked om at slippe og genoprette alle tabeller på SQL Analytics-slutpunktet under opdateringsprocessen. Brug denne indstilling, hvis du har brug for at genopbygge tabeller fuldt ud fra deres kildedefinitioner, f.eks. for at løse uoverensstemmelser eller sikre en ren opdatering. Standardværdien er false.
timeout	Duration	Anmodningens varighed før timeout. Standardværdien er 15 minutter.

SyncStatus

Optælling

Status for synkroniseringshandlingen. Der kan tilføjes flere SyncStatus-typer over tid.

Værdi	Beskrivelse
Success	Angiver, om det lykkedes.
Failure	Angiver en fejl.
NotRun	Angiver, at handlingen ikke blev kørt.

TableSyncStatus

Objekt

Et statusobjekt til tabelsynkronisering.

Name	Type	Beskrivelse
endDateTime	string (date-time)	Den dato og det klokkeslæt, hvor tabelsynkroniseringen blev fuldført i UTC i formatet ÅÅÅÅ-MM-DDTHH:mm:ssZ.
error	ErrorResponseDetails	Oplysninger om fejlsvar
lastSuccessfulSyncDateTime	string (date-time)	Den dato og det klokkeslæt, hvor tabelsynkroniseringen lykkedes i UTC ved hjælp af formatet YYYY-MM-DDTHH:mm:ssZ.
startDateTime	string (date-time)	Den dato og det klokkeslæt, hvor tabelsynkroniseringen startede i UTC i formatet ÅÅÅÅ-MM-DDTHH:mm:ssZ.
status	SyncStatus	Angiver, om tabellen er synkroniseret uden fejl.
tableName	string	Navnet på den tabel, der er synkroniseret.

TableSyncStatuses

Objekt

En liste over status for tabelsynkronisering.

Name	Type	Beskrivelse
value	TableSyncStatus[]	En liste over status for tabelsynkronisering.

TimeUnit

Optælling

Tidsenheden for varigheden. Der kan tilføjes flere varighedstyper over tid.

Værdi	Beskrivelse
Seconds	Varighed i sekunder.
Minutes	Varighed i minutter.
Hours	Varighed i timer.
Days	Varighed i dage.

Del via

Items - Refresh Sql Endpoint Metadata

Permissions

Påkrævede delegerede områder

Microsoft Entra-understøttede identiteter

Interface

URI-parametre

Brødtekst for anmodning

Svar

Eksempler

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

Eksempelanmodning

Eksempelsvar

Definitioner

Duration

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

SqlEndpointRefreshMetadataRequest

SyncStatus

TableSyncStatus

TableSyncStatuses

TimeUnit