Items - Refresh Sql Endpoint Metadata

Servicio:: SQLEndpoint

Versión de la API:: v1

Actualiza todas las tablas dentro de un punto de conexión de SQL Analytics.
Esta API admite operaciones de larga duración (LRO).

Permissions

El autor de la llamada debe tener rol de colaborador o superior.

Ámbitos delegados necesarios

Item.ReadWrite.All

Identidades admitidas de Microsoft Entra

Esta API admite las identidades de Microsoft enumeradas en esta sección.

Identity	Support
User	Yes
Entidad de servicio e Identidades administradas	Yes

Interface

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
sqlEndpointId	path	True	string (uuid)	Identificador del punto de conexión de SQL Analytics.
workspaceId	path	True	string (uuid)	El identificador del área de trabajo.

Cuerpo de la solicitud

Nombre	Tipo	Description
timeout	Duration	Duración de la solicitud antes de que se agote el tiempo de espera. El valor predeterminado es de 15 minutos.

Respuestas

Nombre	Tipo	Description
200 OK	TableSyncStatuses	Solicitud completada correctamente.
202 Accepted		Solicitud aceptada, actualización de la tabla de SQL Analytics en curso. Encabezados Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Códigos de error comunes: ItemNotFound: no se encontró el elemento solicitado.

Nombre

Tipo

Description

200 OK

TableSyncStatuses

Solicitud completada correctamente.

202 Accepted

Solicitud aceptada, actualización de la tabla de SQL Analytics en curso.

Encabezados

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

Other Status Codes

ErrorResponse

Códigos de error comunes:

ItemNotFound: no se encontró el elemento solicitado.

Ejemplos

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

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

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

Definiciones

Nombre	Description
Duration	Duración.
ErrorRelatedResource	Objeto de detalles del recurso relacionado con el error.
ErrorResponse	Respuesta de error.
ErrorResponseDetails	Detalles de la respuesta de error.
SqlEndpointRefreshMetadataRequest	Actualice la carga de la solicitud de punto de conexión analaytics de SQL.
SyncStatus	Estado de la operación de sincronización. Se pueden agregar tipos SyncStatus adicionales a lo largo del tiempo.
TableSyncStatus	Objeto de estado de sincronización de tabla.
TableSyncStatuses	Lista de estados de sincronización de tablas.
TimeUnit	Unidad de tiempo durante la duración. Se pueden agregar tipos de duración adicionales a lo largo del tiempo.

Duration

Object

Duración.

Nombre	Tipo	Description
timeUnit	TimeUnit	Unidad de tiempo durante la duración. Se pueden agregar tipos de duración adicionales a lo largo del tiempo.
value	number	Número de timeUnits en la duración.

ErrorRelatedResource

Object

Objeto de detalles del recurso relacionado con el error.

Nombre	Tipo	Description
resourceId	string	Identificador de recurso implicado en el error.
resourceType	string	Tipo del recurso implicado en el error.

ErrorResponse

Object

Respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
moreDetails	ErrorResponseDetails[]	Lista de detalles de error adicionales.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.
requestId	string	Identificador de la solicitud asociada al error.

ErrorResponseDetails

Object

Detalles de la respuesta de error.

Nombre	Tipo	Description
errorCode	string	Identificador específico que proporciona información sobre una condición de error, lo que permite una comunicación estandarizada entre nuestro servicio y sus usuarios.
message	string	Representación legible del error.
relatedResource	ErrorRelatedResource	Detalles del recurso relacionado con el error.

SqlEndpointRefreshMetadataRequest

Object

Actualice la carga de la solicitud de punto de conexión analaytics de SQL.

Nombre	Tipo	Description
timeout	Duration	Duración de la solicitud antes de que se agote el tiempo de espera. El valor predeterminado es de 15 minutos.

SyncStatus

Enumeración

Estado de la operación de sincronización. Se pueden agregar tipos SyncStatus adicionales a lo largo del tiempo.

Valor	Description
Success	Indica que se ha realizado correctamente.
Failure	Indica un error.
NotRun	Indica que la operación no se ejecutó.

TableSyncStatus

Object

Objeto de estado de sincronización de tabla.

Nombre	Tipo	Description
endDateTime	string (date-time)	Fecha y hora en que se completó la sincronización de tablas en UTC, utilizando el formato AAAA-MM-DDTHH:mm:ssZ.
error	ErrorResponseDetails	Detalles de la respuesta de error
lastSuccessfulSyncDateTime	string (date-time)	Fecha y hora en que la sincronización de tablas se realizó correctamente en UTC, usando el formato AAAA-MM-DDTHH:mm:ssZ.
startDateTime	string (date-time)	Fecha y hora en que se inició la sincronización de tablas en UTC, utilizando el formato AAAA-MM-DDTHH:mm:ssZ.
status	SyncStatus	Indica si la tabla se sincroniza sin errores.
tableName	string	Nombre de la tabla que se sincronice.

TableSyncStatuses

Object

Lista de estados de sincronización de tablas.

Nombre	Tipo	Description
value	TableSyncStatus[]	Lista de estados de sincronización de tablas.

TimeUnit

Enumeración

Unidad de tiempo durante la duración. Se pueden agregar tipos de duración adicionales a lo largo del tiempo.

Valor	Description
Seconds	Duración en segundos.
Minutes	Duración en minutos.
Hours	Duración en horas.
Days	Duración en días.

Compartir a través de

Items - Refresh Sql Endpoint Metadata

Permissions

Ámbitos delegados necesarios

Identidades admitidas de Microsoft Entra

Interface

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

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

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Duration

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

SqlEndpointRefreshMetadataRequest

SyncStatus

TableSyncStatus

TableSyncStatuses

TimeUnit