Consultar Microsoft Fabric HorizonDB

Use o PostgreSQL SQL para consultar os dados operacionais no Fabric HorizonDB. Este artigo utiliza o horizon_sample esquema criado pelo quickstart sample-data.

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.
  • Os dados de Carregar dados de amostra ou de suas próprias tabelas equivalentes.
  • Faça login como criador do banco de dados, a única identidade que pode se conectar ao PostgreSQL na pré-visualização atual.

Inspecionar linhas

Comece com um resultado ordenado e delimitado:

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

PostgreSQL não garante a ordem das linhas sem ORDER BY.

Una clientes e pedidos

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
ORDER BY order_row.order_reference;

A qualificação de esquema torna o destino inequívoco e evita depender de search_path.

Filtro com parâmetros

Os aplicativos devem passar valores como parâmetros do driver. Em uma consulta interativa, você pode usar uma instrução preparada:

PREPARE orders_by_status (text) AS
SELECT
    order_reference,
    order_date,
    total
FROM horizon_sample.orders
WHERE status = $1
ORDER BY order_date DESC;

EXECUTE orders_by_status ('open');

DEALLOCATE orders_by_status;

A vida útil da instrução preparada está vinculada à sessão. Não presuma que ela sobreviva a uma pausa ou a uma transição disruptiva.

Dados agregados

SELECT
    customer.segment,
    count(order_row.order_id) AS order_count,
    coalesce(sum(order_row.total), 0) AS order_total,
    coalesce(avg(order_row.total), 0) AS average_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;

A junção à esquerda mantém um segmento no resultado mesmo quando o customer não tem pedidos.

Analisar um plano de consulta

Use EXPLAIN para inspecionar as operações planejadas sem executar a consulta:

EXPLAIN (COSTS, VERBOSE)
SELECT
    order_reference,
    order_date,
    total
FROM horizon_sample.orders
WHERE customer_id = 1
ORDER BY order_date DESC;

Use EXPLAIN (ANALYZE, BUFFERS) com cuidado porque executa a instrução. Não use ANALYZE em uma instrução que altere dados, a menos que você queira intencionalmente a alteração e a envolva em uma transação apropriada.

Atualizar dados em uma transação

BEGIN;

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

COMMIT;

O predicado de status torna a transição condicional. Se o comando não retorna linhas, outra sessão ou uma execução anterior pode já ter alterado o pedido.

Para fluxos de trabalho de aplicativo passíveis de repetição, use chaves de negócio estáveis e transições de estado idempotentes. Não reproduza uma transação cegamente depois de perder a conexão durante o commit.

Consultar metadados

Encontre tabelas de clientes:

SELECT
    schemaname AS schema_name,
    tablename AS table_name,
    tableowner AS table_owner
FROM pg_catalog.pg_tables
WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
ORDER BY schemaname, tablename;

Encontre as maiores tabelas de clientes:

SELECT
    statistics.schemaname AS schema_name,
    statistics.relname AS table_name,
    pg_total_relation_size(statistics.relid) AS total_bytes,
    pg_size_pretty(pg_total_relation_size(statistics.relid)) AS total_size
FROM pg_catalog.pg_statio_user_tables AS statistics
ORDER BY total_bytes DESC
LIMIT 20;

Solucionar problemas nos resultados da consulta

Sintoma Verificação
Sem fileiras Verifique filtros, visibilidade da transação e se os dados de exemplo foram gravados.
A relação não existe Verifique o banco de dados, esquema, nome e o uso de maiúsculas e minúsculas do identificador entre aspas.
Permissão negada Confirme que você é o criador do banco de dados, inspecione a propriedade do objeto e verifique se a operação é suportada.
A consulta está bloqueada Inspecionar pg_stat_activity e pg_blocking_pids() , se for permitido.
Os dados diferem do endpoint de análise SQL O espelhamento é assíncrono; compare os carimbos de data e o status do espelhamento.
A conexão falha após o tempo ocioso Reconecte com nova tentativa com limite de tentativas enquanto o banco de dados retoma.

Próxima etapa

Conecte-se usando Python.