Compartilhar via

Items - Refresh Sql Endpoint Metadata

Serviço:
SQLEndpoint
Versão da API:
v1

Atualiza todas as tabelas em um ponto de extremidade de análise do SQL.
Essa API dá suporte a LRO (operações de execução longa).

Permissions

O chamador deve ter função de colaborador ou de espaço de trabalho superior.

Escopos delegados necessários

Item.ReadWrite.All

Identidades com suporte do Microsoft Entra

Esta API dá suporte às identidades do Microsoft listadas nesta seção.

Identity Support
User Yes
Entidade de serviço e identidades gerenciadas Yes

Interface

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
sqlEndpointId
 path True

string (uuid)

A ID do ponto de extremidade de análise do SQL.
workspaceId
 path True

string (uuid)

O identificador do espaço de trabalho.

Corpo da solicitação

Nome Tipo Description
timeout

Duration

A duração da solicitação antes do tempo limite. O valor padrão é 15 minutos.

Respostas

Nome Tipo Description
200 OK

TableSyncStatuses

Solicitação concluída com êxito.
202 Accepted

Solicitação aceita, atualização da tabela de análise do SQL em andamento.

Cabeçalhos

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

ErrorResponse

Códigos de erro comuns:

  • ItemNotFound - O item solicitado não foi encontrado.

Exemplos

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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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"
    }
  ]
}

Definições

Nome Description
Duration

Uma duração.
ErrorRelatedResource

O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse

A resposta de erro.
ErrorResponseDetails

Os detalhes da resposta de erro.
SqlEndpointRefreshMetadataRequest

Atualize o conteúdo da solicitação do ponto de extremidade de analaytics do SQL.
SyncStatus

O status da operação de sincronização. Tipos adicionais do SyncStatus podem ser adicionados ao longo do tempo.
TableSyncStatus

Um objeto de status de sincronização de tabela.
TableSyncStatuses

Uma lista de status de sincronização de tabela.
TimeUnit

A unidade de tempo durante a duração. Tipos de duração adicionais podem ser adicionados ao longo do tempo.

Duration

Objeto

Uma duração.

Nome Tipo Description
timeUnit

TimeUnit

A unidade de tempo durante a duração. Tipos de duração adicionais podem ser adicionados ao longo do tempo.
value

number

O número de timeUnits na duração.

ErrorRelatedResource

Objeto

O objeto de detalhes do recurso relacionado ao erro.

Nome Tipo Description
resourceId

string

A ID do recurso envolvida no erro.
resourceType

string

O tipo do recurso envolvido no erro.

ErrorResponse

Objeto

A resposta de erro.

Nome Tipo Description
errorCode

string

Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários.
message

string

Uma representação legível humana do erro.
moreDetails

ErrorResponseDetails[]

Lista de detalhes de erro adicionais.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionado ao erro.
requestId

string

ID da solicitação associada ao erro.

ErrorResponseDetails

Objeto

Os detalhes da resposta de erro.

Nome Tipo Description
errorCode

string

Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários.
message

string

Uma representação legível humana do erro.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionado ao erro.

SqlEndpointRefreshMetadataRequest

Objeto

Atualize o conteúdo da solicitação do ponto de extremidade de analaytics do SQL.

Nome Tipo Description
timeout

Duration

A duração da solicitação antes do tempo limite. O valor padrão é 15 minutos.

SyncStatus

Enumeração

O status da operação de sincronização. Tipos adicionais do SyncStatus podem ser adicionados ao longo do tempo.

Valor Description
Success

Indica um êxito.
Failure

Indica uma falha.
NotRun

Indica que a operação não foi executada.

TableSyncStatus

Objeto

Um objeto de status de sincronização de tabela.

Nome Tipo Description
endDateTime

string (date-time)

A data e hora em que a sincronização de tabela foi concluída em UTC, usando o formato YYYY-MM-DDTHH:mm:ssZ.
error

ErrorResponseDetails

Os detalhes da resposta de erro
lastSuccessfulSyncDateTime

string (date-time)

A data e hora em que a sincronização de tabela foi bem-sucedida em UTC, usando o formato YYYY-MM-DDTHH:mm:ssZ.
startDateTime

string (date-time)

A data e hora em que a sincronização de tabela começou em UTC, usando o formato YYYY-MM-DDTHH:mm:ssZ.
status

SyncStatus

Se a tabela foi sincronizada sem erros.
tableName

string

O nome da tabela sincronizada.

TableSyncStatuses

Objeto

Uma lista de status de sincronização de tabela.

Nome Tipo Description
value

TableSyncStatus[]

Uma lista de status de sincronização de tabela.

TimeUnit

Enumeração

A unidade de tempo durante a duração. Tipos de duração adicionais podem ser adicionados ao longo do tempo.

Valor Description
Seconds

Duração em segundos.
Minutes

Duração em minutos.
Hours

Duração em horas.
Days

Duração em dias.