Consulte o endpoint de SQL Analytics para Microsoft Fabric HorizonDB

O Fabric HorizonDB espelha tabelas PostgreSQL elegíveis para o OneLake e expõe a cópia espelhada por meio de um endpoint de análise SQL somente de leitura. Use este endpoint para consultas analíticas e relatórios sem enviar essas consultas para a carga operacional PostgreSQL.

Importante

Fabric HorizonDB está em prévia pública. Capacidades, limites e comportamento podem mudar antes da disponibilidade geral. Para mais informações, consulte os recursos de pré-visualização do Microsoft Fabric.

Prerequisites

  • Um banco de dados HorizonDB com espelhamento habilitado e inicializado.
  • Pelo menos uma tabela de origem elegível com chave primária.
  • Acesso de leitura ao endpoint de análise SQL e seus dados espelhados.
  • Os nomes do esquema de origem e das tabelas conforme mostrados no endpoint.

O endpoint de análise SQL e o endpoint PostgreSQL usam superfícies de conexão e consulta diferentes. Este procedimento utiliza o endpoint de análise SQL.

Preparar dados de origem

Use o esquema compartilhado horizon_sample para que a tabela de origem permaneça consistente com os outros exemplos do Fabric HorizonDB:

  1. Conclua Criar tabelas.

  2. Conclua Carregar dados de amostra.

  3. No endpoint PostgreSQL, verifique as linhas de origem:

    SELECT
        order_reference,
        order_date,
        status,
        total,
        created_at
    FROM horizon_sample.orders
    ORDER BY order_reference;
    

Não execute os scripts de instalação do PostgreSQL contra o endpoint de análise SQL.

Aguarde pela cópia inicial

  1. Retorne ao espaço de trabalho Fabric.
  2. Encontre o item de espelhamento associado e abra a experiência de estado.
  3. Encontre a tabela horizon_sample.orders.
  4. Espere até que a cópia inicial seja concluída e a tabela informe um estado saudável.
  5. Registre a última aplicação ou atualização das informações que a experiência revela.

Os rótulos exatos de status podem mudar durante a visualização pública. Um estado de prontidão no banco de dados não significa que a cópia analítica inicial foi concluída.

Abra o endpoint de análise SQL

Abra o endpoint de análise SQL associado ao banco de dados HorizonDB a partir do espaço de trabalho ou da experiência analítica do banco de dados. Confirme que o item selecionado é o endpoint de análise SQL, e não o editor de consultas PostgreSQL.

O nome do esquema ou da tabela espelhada pode diferir do nome no PostgreSQL, como um esquema _public. Use os nomes exibidos pelo explorador de endpoint.

Executar uma consulta de validação

Execute uma consulta limitada sobre a tabela espelhada:

SELECT TOP (100)
    order_reference,
    order_date,
    status,
    total,
    created_at
FROM horizon_sample.orders
WHERE order_date >= '2026-01-01'
ORDER BY order_date DESC;

Se o endpoint representar o esquema ou a tabela com outro nome publicado, atualize a consulta de acordo.

Execute um agregado adequado para um relatório:

SELECT
    status,
    COUNT(*) AS order_count,
    SUM(total) AS order_total
FROM horizon_sample.orders
GROUP BY status
ORDER BY status;

Compare os dados de origem e os dados espelhados

No endpoint PostgreSQL, conecte-se como criador do banco de dados e registre uma marca de nível máximo estável:

SELECT
    count(*) AS source_order_count,
    max(order_id) AS source_latest_order_id,
    max(created_at) AS source_latest_created_at
FROM horizon_sample.orders;

Execute uma contagem equivalente e uma consulta de máximo contra o endpoint de análise SQL. Pequenas diferenças podem ser esperadas enquanto o espelhamento aplica alterações confirmadas.

Se os valores não convergirem:

  1. Verifique o status de espelhamento e as informações de lag da tabela.
  2. Confirme que a tabela, a chave, as colunas e o DDL recente são elegíveis.
  3. Verifique se uma cópia inicial ou reseed está em andamento.
  4. Evite alterar continuamente a origem enquanto coleta uma comparação estável.
  5. Siga Solução de Problemas de Espelhamento do Fabric HorizonDB.

Usar timestamps analíticos

Inclua um evento de origem ou timestamp de atualização em tabelas usadas para relatórios sensíveis à atualidade dos dados. Um relatório pode mostrar o timestamp mais recente da fonte:

SELECT
    MAX(created_at) AS latest_source_timestamp
FROM horizon_sample.orders;

Este valor descreve a linha espelhada mais recente no resultado. Não é uma garantia de nível de serviço de espelhamento.

Consulte com segurança

  • Mantenha as consultas analíticas no endpoint de análise SQL.
  • Não use sucesso de endpoint como evidência de que o PostgreSQL está pronto ou atual.
  • Não tente gravar em tabelas espelhadas.
  • Espere que as alterações no esquema exijam atualização de metadados ou reseeding.
  • Aplique a segurança separadamente à superfície analítica espelhada.

Próxima etapa