Sincronização de metadados do endpoint de análise SQL

Este artigo descreve o que é o endpoint de análise SQL, como se mantém sincronizado com o seu lakehouse e os controlos que tem para gerir essa sincronização. O endpoint de análise SQL deteta automaticamente a alteração e atualiza os seus metadados SQL através de um processo em segundo plano. Também pode atualizar manualmente os metadados do ponto final de análise SQL através do portal do Fabric, da API REST ou do procedimento armazenado T-SQL.

O processo de sincronização de metadados em segundo plano lê os registos Delta da /Tables pasta no OneLake e mantém o esquema SQL atualizado.

O Microsoft Fabric mantém automaticamente o endpoint de análise SQL sincronizado com o lakehouse subjacente. Não há infraestrutura para configurar e, na maioria dos casos, não é necessária qualquer ação do utilizador. A plataforma é responsável por:

  • Descoberta de tabelas - detetar tabelas Delta recém-criadas ou eliminadas no lakehouse, e criar ou remover as tabelas SQL correspondentes no endpoint.
  • Atualidade dos dados - detetar alterações (inserções, atualizações e eliminações) efetuadas nos dados das tabelas existentes e garantir que as consultas devolvem resultados atualizados.
  • Deteção de alterações de esquema - detetar adições, remoções ou alterações de tipo de colunas em tabelas Delta existentes e atualizar a definição correspondente da tabela SQL.

Para detalhes sobre como esta sincronização funciona e fatores que afetam a latência da sincronização, consulte considerações de desempenho em endpoints de análise SQL.

Deteção de alterações de esquema e sincronização de metadados

Cada Lakehouse, armazém, base de dados e base de dados espelhada no Fabric é automaticamente provisionada com o seu próprio endpoint de análise SQL, para que possa consultar tabelas Delta com T-SQL e o protocolo TDS, sem mover ou copiar dados.

  • Cada Lakehouse, armazém de dados, base de dados e base de dados espelhada tem exatamente um endpoint de análise SQL.
  • Cada tabela Delta no item subjacente surge automaticamente como uma tabela SQL no endpoint.
  • O endpoint é só de leitura nas tabelas geradas automaticamente. Pode estender o modelo com os seus próprios esquemas SQL, vistas, procedimentos armazenados e funções.
  • O endpoint é alimentado pelo mesmo motor de computação que Fabric Data Warehouse, pelo que fornece consultas SQL de alto desempenho e baixa latência contra ficheiros Delta abertos.

Nova sincronização de metadados (pré-visualização)

Importante

Este recurso está em pré-visualização.

Em maio de 2026, foi anunciada a nova sincronização de metadados para o endpoint de análise SQL como uma funcionalidade de pré-visualização. Pode ativar o novo processo de sincronização de metadados, que se aplica apenas a novos endpoints de análise SQL. A nova opção de sincronização de metadados permite manter os dados disponíveis para serem consultados poucos segundos após darem entrada no lakehouse.

O novo processo de sincronização de metadados inclui as seguintes funcionalidades:

  • Uma nova arquitetura externa baseada em tabelas para analisar registos Delta e criar o catálogo.
  • Uma arquitetura desacoplada que deteta alterações de esquema e dados separadamente e atualiza o catálogo em conformidade.
  • Uma atualização de antecedentes que verifica periodicamente as atualizações dos dados.
  • Uma atualização dos dados a pedido quando é recebida uma consulta de leitura e o sistema detetar que os dados não estão atualizados.

Ativar a sincronização de novos metadados

Pode ativar a nova sincronização de metadados nos espaços de trabalho indo às definições do Armazém , nas definições do Espaço de Trabalho.

Captura de ecrã do portal Fabric, página Definições do espaço de trabalho, que mostra a opção Nova sincronização de metadados do Warehouse e o painel Nova sincronização de metadados (pré-visualização).

Quando ativas a nova sincronização de metadados, os novos endpoints de análise SQL no espaço de trabalho sincronizam mais rapidamente ao atualizar as alterações das tabelas subjacentes. Os endpoints de análise SQL existentes não são afetados.

Descobrir quando os metadados foram atualizados pela última vez

Se estiver a usar a nova versão da sincronização de metadados, pode usar vistas de gestão dinâmica (DMVs) para obter detalhes sobre a atualização mais recente do endpoint de análise SQL. Utilize o sys.dm_db_external_tables_log_status DMV para obter detalhes sobre a sincronização de metadados mais recente:

  • last_update_time_utc: Carimbo temporal da última vez que a tabela foi atualizada com novos dados.
  • latest_log_version: A versão do registo de transações com o maior Delta da tabela que foi atualizada.
  • latest_checkpoint_version: A versão mais recente do ponto de controlo Delta que foi processada.
  • is_blocked: Indica se a última tentativa de atualização da tabela foi bloqueada (1) ou bem-sucedida (0).

Para mais informações, consulte sys.dm_db_external_tables_log_status.

Limitações da nova sincronização de metadados

  • A nova sincronização de metadados não suporta ponto de verificação multipartes, uma funcionalidade do Delta obsoleta. Se as suas tabelas lakehouse contiverem checkpoints de várias partes, não são atualizadas na nova sincronização de metadados.

Atualização manual

Para além dos processos em segundo plano que atualizam automaticamente os dados, pode atualizar manualmente os metadados:

  • Atualizar a partir do portal: No editor do ponto final de análise SQL no portal Fabric, selecione o ícone Atualizar na barra de ferramentas do Explorador para forçar uma sincronização de metadados a pedido. Aceda a Consulta no seu ponto final de análise SQL e procure o botão de atualização na barra de ferramentas.

    Captura de ecrã do portal do Fabric a mostrar o botão Atualizar esquema do endpoint de análise SQL.

  • Atualizar com a API REST: Utilize a API REST Refresh SQL endpoint metadata para atualizar programaticamente os metadados de um endpoint de análise SQL.

  • Atualizar via procedimento armazenado: Use o procedimento armazenado do sistema sys.sp_dw_refresh_ext_table para atualizar os dados de uma tabela específica dentro de um endpoint de análise SQL. Este método T-SQL só está disponível se o endpoint de análise SQL foi criado após ativar a nova sincronização de metadados (pré-visualização). Por exemplo:

    EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";

Use a API apenas se tiver alterações no esquema, como adicionar ou eliminar tabelas ou colunas, ou alterar tipos de colunas, e precisar de atualizar todo o item. Para alterações apenas aos dados num endpoint de análise SQL, utilize o procedimento armazenado do sistema sys.sp_dw_refresh_ext_table para atualizar uma tabela específica.

Para ajustar as tabelas Delta subjacentes para obter a melhor sincronização de metadados e desempenho de consultas, consulte considerações sobre o desempenho dos endpoints de análise SQL.

Conteúdo relacionado

  • Last updated on