Partager via

Items - Refresh Sql Endpoint Metadata

Service:
SQLEndpoint
Version d'API:
v1

Actualise toutes les tables au sein d’un point de terminaison d’analyse SQL.
Cette API prend en charge opérations longues (LRO).

Permissions

L’appelant doit avoir rôle de contributeur ou supérieur.

Étendues déléguées requises

Item.ReadWrite.All

Identités prises en charge par Microsoft Entra

Cette API prend en charge les identités Microsoft répertoriées dans cette section.

Identity Support
User Yes
Service principal et identités gérées Yes

Interface

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

Paramètres URI

Nom Dans Obligatoire Type Description
sqlEndpointId
 path True

string (uuid)

ID de point de terminaison d’analytique SQL.
workspaceId
 path True

string (uuid)

Identifiant de l’espace de travail.

Corps de la demande

Nom Type Description
timeout

Duration

Durée de la demande avant expiration du délai d’attente. La valeur par défaut est de 15 minutes.

Réponses

Nom Type Description
200 OK

TableSyncStatuses

La demande s’est terminée avec succès.
202 Accepted

Demande acceptée, actualisation de la table d’analyse SQL en cours.

En-têtes

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Codes d’erreur courants :

  • ItemNotFound : l’élément demandé n’a pas été trouvé.

Exemples

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

Exemple de requête

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

Exemple de réponse

Code d’état:
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"
    }
  ]
}

Définitions

Nom Description
Duration

Durée.
ErrorRelatedResource

Objet de détails de ressource associé à l’erreur.
ErrorResponse

Réponse d’erreur.
ErrorResponseDetails

Détails de la réponse d’erreur.
SqlEndpointRefreshMetadataRequest

Actualisez la charge utile de la demande de point de terminaison analaytique SQL.
SyncStatus

État de l’opération de synchronisation. Des types SyncStatus supplémentaires peuvent être ajoutés au fil du temps.
TableSyncStatus

Objet d’état de synchronisation de table.
TableSyncStatuses

Liste des états de synchronisation des tables.
TimeUnit

Unité de temps pour la durée. Des types de durée supplémentaires peuvent être ajoutés au fil du temps.

Duration

Object

Durée.

Nom Type Description
timeUnit

TimeUnit

Unité de temps pour la durée. Des types de durée supplémentaires peuvent être ajoutés au fil du temps.
value

number

Nombre d’unités de temps dans la durée.

ErrorRelatedResource

Object

Objet de détails de ressource associé à l’erreur.

Nom Type Description
resourceId

string

ID de ressource impliqué dans l’erreur.
resourceType

string

Type de la ressource impliquée dans l’erreur.

ErrorResponse

Object

Réponse d’erreur.

Nom Type Description
errorCode

string

Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message

string

Représentation lisible humaine de l’erreur.
moreDetails

ErrorResponseDetails[]

Liste des détails d’erreur supplémentaires.
relatedResource

ErrorRelatedResource

Détails de la ressource associée à l’erreur.
requestId

string

ID de la demande associée à l’erreur.

ErrorResponseDetails

Object

Détails de la réponse d’erreur.

Nom Type Description
errorCode

string

Identificateur spécifique qui fournit des informations sur une condition d’erreur, ce qui permet une communication standardisée entre notre service et ses utilisateurs.
message

string

Représentation lisible humaine de l’erreur.
relatedResource

ErrorRelatedResource

Détails de la ressource associée à l’erreur.

SqlEndpointRefreshMetadataRequest

Object

Actualisez la charge utile de la demande de point de terminaison analaytique SQL.

Nom Type Description
timeout

Duration

Durée de la demande avant expiration du délai d’attente. La valeur par défaut est de 15 minutes.

SyncStatus

Énumération

État de l’opération de synchronisation. Des types SyncStatus supplémentaires peuvent être ajoutés au fil du temps.

Valeur Description
Success

Indique une réussite.
Failure

Indique une défaillance.
NotRun

Indique que l’opération n’a pas été exécutée.

TableSyncStatus

Object

Objet d’état de synchronisation de table.

Nom Type Description
endDateTime

string (date-time)

Date et heure de fin de la synchronisation de la table au format UTC à l’aide du format AAAA-MM-DDTHH :mm :ssZ.
error

ErrorResponseDetails

Détails de la réponse d’erreur
lastSuccessfulSyncDateTime

string (date-time)

Date et heure de réussite de la synchronisation de la table au format UTC à l’aide du format AAAA-MM-DDTHH :mm :ssZ.
startDateTime

string (date-time)

Date et heure de début de la synchronisation de table au format UTC à l’aide du format AAAA-MM-DDTHH :mm :ssZ.
status

SyncStatus

Indique si la table est synchronisée sans erreur.
tableName

string

Nom de la table qui a été synchronisée.

TableSyncStatuses

Object

Liste des états de synchronisation des tables.

Nom Type Description
value

TableSyncStatus[]

Liste des états de synchronisation des tables.

TimeUnit

Énumération

Unité de temps pour la durée. Des types de durée supplémentaires peuvent être ajoutés au fil du temps.

Valeur Description
Seconds

Durée en secondes.
Minutes

Durée en minutes.
Hours

Durée en heures.
Days

Durée en jours.