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

Este artigo descreve o que é o ponto de extremidade de análise do SQL, como ele permanece em sincronia com o lakehouse e os controles que você precisa para gerenciar essa sincronização. O ponto de extremidade de análise do SQL detecta automaticamente a alteração e atualiza os metadados do SQL por meio de um processo em segundo plano. Você também pode manualmente atualizar metadados do ponto de extremidade da análise do SQL por meio do portal Fabric, da API REST ou do procedimento armazenado do T-SQL.

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

O Microsoft Fabric mantém automaticamente o endpoint analítico SQL sincronizado com o lakehouse subjacente. Não há infraestrutura para configurar e, na maioria dos casos, nenhuma ação de usuário é necessária. A plataforma é responsável por:

  • Descoberta de tabelas - detecta tabelas Delta recém-criadas ou excluídas no lakehouse e cria ou remove as tabelas SQL correspondentes no endpoint.
  • Atualidade dos dados - detecção de alterações (inserções, atualizações, exclusões) feitas nos dados em tabelas existentes e garantia de que as consultas retornem resultados atualizados.
  • Detecção de alterações de esquema – detectando adições de coluna, remoções ou alterações de tipo em tabelas Delta existentes e atualizando a definição de tabela SQL correspondente.

Para obter detalhes sobre como essa sincronização funciona e fatores que afetam a latência de sincronização, consulte as considerações sobre o desempenho do ponto de extremidade da análise de SQL.

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

Cada lakehouse, warehouse, banco de dados e banco de dados espelhado no Fabric recebe automaticamente seu próprio endpoint de análise SQL, para que você possa consultar tabelas Delta com T-SQL e o protocolo TDS, sem mover nem copiar dados.

  • Cada Lakehouse, warehouse, banco de dados e banco de dados espelhado tem exatamente um endpoint de análise SQL.
  • Cada tabela Delta no item subjacente é automaticamente exposta como uma tabela SQL no endpoint.
  • O endpoint é apenas para leitura nas tabelas geradas automaticamente. Você pode estender o modelo com seus próprios esquemas SQL, exibições, procedimentos armazenados e funções.
  • O endpoint usa o mesmo mecanismo de computação que o Fabric Data Warehouse, portanto fornece consultas SQL de alto desempenho e baixa latência sobre arquivos Delta abertos.

Nova sincronização de metadados (versão prévia)

Importante

Esse recurso está na versão prévia.

Em maio de 2026, a nova sincronização de metadados para o endpoint de análise SQL foi anunciada como um recurso em versão prévia. Você pode habilitar o novo processo de sincronização de metadados, que se aplica apenas aos novos terminais de análise SQL. A nova opção de sincronização de metadados funciona para manter os dados disponíveis para consulta em segundos após o pouso no lakehouse.

O novo processo de sincronização de metadados inclui os seguintes recursos:

  • Uma nova arquitetura externa baseada em tabelas para analisar logs Delta e criar o catálogo.
  • Uma arquitetura desacoplada que detecta alterações de esquema e dados separadamente e atualiza o catálogo adequadamente.
  • Uma atualização em segundo plano que verifica se há atualizações de dados periodicamente.
  • Uma atualização sob demanda dos dados quando uma consulta de leitura é recebida e o sistema detecta que os dados não estão atualizados.

Habilitar nova sincronização de metadados

Você pode habilitar a nova sincronização de metadados em workspaces acessando as configurações do Warehouse nas configurações do Workspace.

Captura de tela da página Configurações do espaço de trabalho no portal do Fabric, mostrando a opção de sincronização de novos metadados do Novo Warehouse e o painel Nova sincronização de metadados (versão prévia).

Quando você ativa a nova sincronização de metadados, novos endpoints do SQL Analytics no espaço de trabalho são sincronizados mais rapidamente quando as alterações nas tabelas subjacentes são atualizadas. Os endpoints de análise SQL existentes não são afetados.

Localizar quando os metadados foram atualizados pela última vez

Se você estiver usando a nova versão da sincronização de metadados, poderá usar exibições de gerenciamento dinâmico (DMVs) para obter detalhes sobre a atualização mais recente do ponto de extremidade de análise SQL. Use a sys.dm_db_external_tables_log_status DMV para obter detalhes sobre a sincronização de metadados mais recente:

  • last_update_time_utc: Data e hora da última vez que a tabela foi atualizada com novos dados.
  • latest_log_version: a versão mais alta do log de transações Delta da tabela que foi atualizada.
  • latest_checkpoint_version: versão mais recente do ponto de verificação Delta que foi processada.
  • is_blocked: indica se a última tentativa na atualização da tabela foi bloqueada (1) ou bem-sucedida (0).

Para obter 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 dá suporte ao ponto de verificação de várias partes, um recurso delta preterido. Se as tabelas lakehouse contiverem pontos de verificação de várias partes, elas não serão atualizadas na nova sincronização de metadados.

Atualização manual

Além dos processos em segundo plano que atualizam dados automaticamente, você pode atualizar manualmente os metadados:

  • Atualize pelo portal: no editor de ponto de extremidade de análise SQL do portal do Fabric, selecione o ícone Atualizar na barra de ferramentas do Explorador para forçar uma sincronização de metadados sob demanda. Acesse Consultar no seu ponto de extremidade de análise SQL e procure o botão Atualizar na barra de ferramentas.

    Captura de tela do portal do Fabric mostrando o botão Atualizar esquema do endpoint de SQL Analytics.

  • Atualização com a API REST: Use a API REST Refresh SQL endpoint metadata para atualizar programaticamente os metadados de um endpoint de análises SQL.

  • Atualização via procedimento armazenado: Use o procedimento armazenado do sistema sys.sp_dw_refresh_ext_table para atualizar os dados de uma tabela específica em um ponto de extremidade de análise SQL. Esse método T-SQL só está disponível se o ponto de extremidade de análise SQL tiver sido criado após a habilitação da Nova sincronização de metadados (versão prévia). Por exemplo:

    EXEC sys.sp_dw_refresh_ext_table "dbo.publicholidays";

Use a API somente se você tiver alterações de esquema, como adicionar ou excluir tabelas ou colunas, ou alterar tipos de colunas e precisar atualizar o item inteiro. Para alterações apenas nos dados em um endpoint de análise SQL, use o procedimento armazenado do sistema sys.sp_dw_refresh_ext_table para atualizar uma tabela específica.

Para ajustar as tabelas Delta subjacentes a fim de obter a melhor sincronização de metadados e o melhor desempenho de consulta, consulte considerações de desempenho do endpoint de análise SQL.

Conteúdo relacionado

  • Last updated on