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.
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. |