Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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:
Conclua Criar tabelas.
Conclua Carregar dados de amostra.
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
- Retorne ao espaço de trabalho Fabric.
- Encontre o item de espelhamento associado e abra a experiência de estado.
- Encontre a tabela
horizon_sample.orders. - Espere até que a cópia inicial seja concluída e a tabela informe um estado saudável.
- 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:
- Verifique o status de espelhamento e as informações de lag da tabela.
- Confirme que a tabela, a chave, as colunas e o DDL recente são elegíveis.
- Verifique se uma cópia inicial ou reseed está em andamento.
- Evite alterar continuamente a origem enquanto coleta uma comparação estável.
- 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.