Tutorial: Use o ponto de extremidade de análise SQL para Microsoft Fabric HorizonDB

Nesta etapa tutorial, você valida o espelhamento do Fabric HorizonDB e consulta a cópia analítica assíncrona através do endpoint de análise SQL.

Important

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

O endpoint de análise SQL e o endpoint PostgreSQL são separados. Esta etapa usa o endpoint PostgreSQL apenas para estabelecer uma marca alta de origem. Execute consultas analíticas no endpoint de análise SQL.

Registre o estado de origem do PostgreSQL

No editor SQL do Fabric HorizonDB, conecte-se como criador do banco de dados e execute:

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

Registre o resultado. Para os dados do tutorial inalterados:

  • source_order_count é 3.
  • source_order_total é 2655.75.
  • O ID mais recente e o carimbo de data identificam a marca de limite máximo atual da origem.

Revisar espelhamento

  1. Retorne ao espaço de trabalho, localize o item de espelhamento associado a contoso-orders-db e abra a visualização de status.
  2. Localize horizon_sample.customers e horizon_sample.orders.
  3. Aguarde a cópia inicial de ambas as tabelas elegíveis ser concluída.
  4. Confirme que nenhuma das tabelas reporta um estado de falha, bloqueado ou de reseeding.
  5. Registre as informações de última aplicação, atualização ou lag exibidas pela experiência publicada.

Os rótulos exatos do estado podem mudar durante a pré-visualização pública. Prontidão para banco de dados não significa que a cópia analítica esteja atualizada.

Se uma tabela não aparecer, confirme sua chave, colunas e DDL recente em relação a as limitações de espelhamento.

Abra o endpoint de análise SQL

  1. Retorne à experiência analítica do espaço de trabalho ou banco de dados.
  2. Abra o endpoint de análise SQL associado a contoso-orders-db.
  3. Confirme que o explorador de endpoint exibe as tabelas espelhadas de clientes e pedidos.
  4. Use os nomes do esquema e das tabelas exibidos pelo endpoint.
  5. Abra uma nova consulta no endpoint de SQL analytics.

O nome do esquema espelhado pode diferir do nome do esquema PostgreSQL, como um esquema transformado _public . Atualize os exemplos a seguir para usar o nome exibido pelo seu endpoint.

Consultar ordens espelhadas

Executar:

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

O resultado deve conter os três pedidos do tutorial após a sincronização do espelhamento.

Execute um agregado analítico:

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

Os dados do tutorial inalterados produzem uma linha para completed, open, e processing.

Comparar o estado de origem e o estado espelhado

No endpoint de análise SQL, execute:

SELECT
    COUNT(*) AS mirrored_order_count,
    MAX(order_id) AS mirrored_latest_order_id,
    MAX(created_at) AS mirrored_latest_created_at,
    SUM(total) AS mirrored_order_total
FROM horizon_sample.orders;

Compare esses valores com os valores de origem que você registrou.

Pequenas diferenças podem ser esperadas enquanto alterações confirmadas estão sendo aplicadas. Se os valores não convergirem:

  1. Pare de alterar as tabelas de origem enquanto coleta uma comparação estável.
  2. Verifique o status de espelhamento e as informações de lag da tabela.
  3. Confirme que uma cópia inicial ou reseed não está em andamento.
  4. Verifique a tabela, a chave, a coluna, o tipo e a elegibilidade de DDL.
  5. Siga Solução de Problemas de Mirroring do Fabric HorizonDB.

Não descreva o endpoint como transacionalmente atual ou síncrono. Inclua carimbos de data-hora de origem em relatórios sensíveis à atualidade dos dados.

Verifique o comportamento somente de leitura

Use o endpoint de análise SQL para consultas, modelos semânticos e relatórios. Não tente inserir, atualizar ou excluir linhas espelhadas do Fabric HorizonDB através dele.

Gravações operacionais continuam a usar o endpoint PostgreSQL. As permissões sobre a fonte do PostgreSQL e a cópia analítica também são separadas.

Resultado esperado

O endpoint de análise SQL mostra as tabelas de tutorial espelhadas, retorna três ordens com um total de 2655.75, e atinge o mesmo nível estável de máximo que a fonte PostgreSQL após o espelhamento se atualizar.

Próxima etapa