Tutorial: Consultar e inspecionar o Microsoft Fabric HorizonDB

Nesta etapa tutorial, você consulta o banco de dados HorizonDB, inspeciona metadados PostgreSQL e revisa o estado básico de monitoramento, segurança e integração.

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

  • Conclua Criar tabelas e carregar dados.
  • Abra o contoso-orders-db.
  • Faça login como criador do banco de dados. Outros usuários e entidades de segurança não podem se conectar ao PostgreSQL na pré-visualização atual.

Consulta de abertura e processamento de pedidos

Abra uma nova consulta no endpoint PostgreSQL e execute:

SELECT
    order_row.order_reference,
    customer.customer_name,
    customer.segment,
    order_row.order_date,
    order_row.status,
    order_row.total
FROM horizon_sample.orders AS order_row
JOIN horizon_sample.customers AS customer
  ON customer.customer_id = order_row.customer_id
WHERE order_row.status IN ('open', 'processing')
ORDER BY order_row.order_date DESC, order_row.order_reference;

O resultado contém ORD-1001 e ORD-1002.

Agregue os pedidos por segmento de clientes

Executar:

SELECT
    customer.segment,
    count(order_row.order_id) AS order_count,
    coalesce(sum(order_row.total), 0) AS order_total
FROM horizon_sample.customers AS customer
LEFT JOIN horizon_sample.orders AS order_row
  ON order_row.customer_id = customer.customer_id
GROUP BY customer.segment
ORDER BY customer.segment;

Resultados esperados:

Segmento Contagem de pedidos Total da ordem
Comercial 1 425,50
Enterprise 2 2230,25

Teste uma atualização em uma transação

Use uma transação explícita para que os dados do tutorial permaneçam inalterados:

BEGIN;

UPDATE horizon_sample.orders
SET status = 'processing'
WHERE order_reference = 'ORD-1001'
  AND status = 'open';

SELECT
    order_reference,
    status
FROM horizon_sample.orders
WHERE order_reference = 'ORD-1001';

ROLLBACK;

A consulta dentro da transação reporta processing. Após ROLLBACK, ORD-1001 permanece open.

Não deixe transações abertas no editor. Transações ociosas podem manter bloqueios. Se uma conexão cair enquanto um commit está em andamento, reconecte e verifique o registro comercial antes de refazer uma gravação.

Inspecionar objetos e extensões

Atualize o explorador de objetos, expanda horizon_samplee confirme que ambas as tabelas do tutorial estão presentes.

Liste os mesmos objetos com SQL:

SELECT
    table_schema,
    table_name,
    table_type
FROM information_schema.tables
WHERE table_schema = 'horizon_sample'
ORDER BY table_name;

Veja as extensões instaladas:

SELECT
    extension.extname AS extension_name,
    extension.extversion AS installed_version,
    namespace.nspname AS schema_name
FROM pg_catalog.pg_extension AS extension
JOIN pg_catalog.pg_namespace AS namespace
  ON namespace.oid = extension.extnamespace
ORDER BY extension.extname;

O serviço gerencia suas extensões criadas automaticamente. Não os crie, exclua, substitua ou altere.

Se você planeja consultar uma fonte Fabric elegível, verifique a extensão de federação:

SELECT
    extname,
    extversion
FROM pg_catalog.pg_extension
WHERE extname = 'pg_fabric_fdw';

Você usa essa integração gerenciada mais tarde em Consultar dados espelhados do Fabric no Fabric HorizonDB.

Analise o monitoramento básico

Execute esta consulta de estatísticas de banco de dados nativa do PostgreSQL:

SELECT
    datname AS database_name,
    numbackends AS active_connections,
    xact_commit,
    xact_rollback,
    blks_read,
    blks_hit,
    temp_files,
    temp_bytes,
    deadlocks,
    stats_reset
FROM pg_catalog.pg_stat_database
WHERE datname = current_database();

A consulta retorna uma linha para o banco de dados atual. Contadores podem ser resetados, atrasados ou ficar indisponíveis enquanto o banco de dados está pausado. Falta de telemetria não é o mesmo que atividade zero.

Inspecione sua sessão atual:

SELECT
    pid,
    usename,
    application_name,
    state,
    xact_start,
    query_start,
    wait_event_type,
    wait_event
FROM pg_catalog.pg_stat_activity
WHERE pid = pg_backend_pid();

A visibilidade sobre outras sessões e o texto completo da consulta depende dos privilégios do PostgreSQL. O texto da consulta pode conter valores sensíveis, então não cole resultados não revisados em capturas de tela ou solicitações de suporte.

Para orientações mais amplas de monitoramento, consulte Monitor Fabric HorizonDB.

Revise autenticação e autorização

Executar:

SELECT
    current_user AS signed_in_user,
    session_user,
    has_schema_privilege(current_user, 'horizon_sample', 'USAGE')
        AS can_use_sample_schema,
    has_table_privilege(
        current_user,
        'horizon_sample.customers',
        'SELECT'
    ) AS can_read_customers,
    has_table_privilege(
        current_user,
        'horizon_sample.orders',
        'SELECT'
    ) AS can_read_orders;

Confirme se a identidade representa seu principal Microsoft Entra e que as verificações necessárias retornam true.

Compartilhar o item do banco de dados não permite que outros usuários ou entidades de segurança se conectem ao PostgreSQL. Também não concede acesso a superusuário ou host. Reveja a autenticação, Autorização e Valide o acesso ao PostgreSQL.

Para um exercício opcional na área de trabalho, selecione Visual Studio Code na barra de ferramentas do Fabric, abra a conexão, escolha Entra Auth e faça login como criador. Atualize a árvore de Conexões do PostgreSQL após criar objetos. Veja Conectar com Visual Studio Code.

Verifique o estado da integração

Abra a experiência de integração ou espelhamento do banco de dados. Confirme que ele não reporta uma dependência falhada antes do próximo passo. O progresso da cópia inicial pode continuar após o PostgreSQL ficar pronto.

Saúde do PostgreSQL, saúde do espelhamento, estado de endpoint de análise SQL, estado de federação e saúde do trabalho Copy são independentes.

Solucionar consultas problemáticas

Sintoma Resolução
A autenticação é bem-sucedida, mas uma consulta é negada Confirme a identidade do criador, a propriedade do objeto e a operação suportada.
Não se encontra nenhuma relação Verifique o banco de dados, a qualificação do esquema, a ortografia e o uso de maiúsculas/minúsculas do identificador entre aspas.
O explorador não mostra uma tabela Atualize-o e verifique o objeto através de information_schema.
Uma consulta aguarda Revise o estado do ciclo de vida, o estado da transação e as sessões de bloqueio se tiver permissão.
Uma conexão é redefinida Reabra a consulta e reconcilie com segurança qualquer gravação anterior antes de tentar novamente.

Próxima etapa