Consulte o Microsoft Fabric HorizonDB com o editor SQL

O editor SQL do Fabric HorizonDB executa o PostgreSQL SQL contra o endpoint operacional do PostgreSQL. Use isso para criar e inspecionar esquemas de propriedade do cliente, consultar dados, testar transações e revisar erros do 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

  • Acesso ao espaço de trabalho Fabric e ao banco de dados HorizonDB.
  • Faça login como o usuário do Microsoft Entra que criou o banco de dados.

Outros usuários e principais não podem se conectar ao PostgreSQL na pré-visualização atual, mesmo que consigam abrir o item. Veja Validar acesso ao PostgreSQL.

Abrir uma consulta

  1. Abra o banco de dados HorizonDB no portal Fabric.

  2. Selecione Nova Consulta.

  3. Confirme que o editor tem como alvo o banco de dados operacional, e não o endpoint de análise SQL.

  4. Executar:

    SELECT
        current_database() AS database_name,
        current_user AS signed_in_user,
        pg_backend_pid() AS session_id,
        clock_timestamp() AS connected_at;
    

O resultado deve identificar o banco de dados selecionado e a identidade efetiva do seu principal Microsoft Entra.

Cole a consulta, selecione a instrução completa e selecione Executar. Confirme que uma linha aparece na grade de resultados e revise a área de mensagens em busca de avisos ou erros.

Trabalhar com demonstrativos

O editor pode executar uma instrução selecionada ou o texto atual da consulta de acordo com os controles mostrados na experiência publicada. Para tornar os scripts previsíveis:

  • Terminar as declarações com ponto e vírgula.
  • Use a sintaxe e os tipos de dados do PostgreSQL.
  • Qualifique tabelas de clientes com seus respectivos esquemas.
  • Use identificadores minúsculos, sem aspas, a menos que a distinção entre maiúsculas e minúsculas seja intencional.
  • Evite executar instruções prejudiciais junto com consultas não relacionadas.
  • Adicione ORDER BY quando a ordem de linhas for relevante.
  • Adicione uma cláusula seletiva WHERE e um LIMIT razoável ao explorar tabelas grandes.

Por exemplo:

SELECT
    order_row.order_reference,
    customer.customer_name,
    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
LIMIT 100;

Ver resultados e mensagens

Comandos bem-sucedidos que retornam linhas exibem uma grade de resultados. Revisão:

  • Nomes de colunas e tipos PostgreSQL.
  • O número de linhas retornadas.
  • Valores nulos e precisão numérica.
  • Notificações ou avisos do servidor.
  • Status de execução e tempo decorrido quando disponível.

Um conjunto de resultados vazio pode estar correto. Isso não é prova de que o comando falhou. Por outro lado, uma grade de resultados não prova que uma operação separada de espelhamento ou de trabalho de cópia seja saudável.

Erros PostgreSQL normalmente identificam uma categoria e posição de erro. Leia a mensagem completa antes de alterar o comando. Causas comuns incluem qualificação de esquema ausente, diferenciação entre maiúsculas e minúsculas em identificadores entre aspas, cast inválido, violação de restrição ou privilégios insuficientes.

Use transações explícitas

A sessão do editor pode permanecer aberta entre as instruções, portanto, torne explícitas as fronteiras de transação para alterações relacionadas:

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';

COMMIT;

Use ROLLBACK; em vez de COMMIT; quando a validação falhar.

Não deixe uma transação aberta. Uma transação ociosa pode manter bloqueios e impedir manutenção. Se uma conexão cair enquanto COMMIT está em andamento, o resultado pode ser indeterminado; reconecte e verifique o registro comercial antes de reproduzir a alteração.

Pesquisar os objetos de banco de dados

Use o explorador de objetos para navegar por esquemas, tabelas, visualizações, funções e extensões suportadas. Após DDL:

  1. Atualize o esquema ou grupo de objetos relevante.
  2. Expanda o schema pertencente ao cliente.
  3. Inspecionar colunas, restrições e índices.
  4. Confirme se o objeto exibido corresponde ao banco de dados e ao esquema usados pela consulta.

Se o explorador estiver obsoleto, verifique o objeto com catálogos PostgreSQL:

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

Inspecionar a atividade de consulta

Para inspecionar 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 de outras sessões e do texto da consulta depende dos privilégios do PostgreSQL. O texto da consulta pode conter valores sensíveis; não cole saídas não revisadas em issues ou capturas de tela.

Lidar com operações demoradas

  • Mantenha a aba de consulta aberta enquanto uma instrução estiver em execução, a menos que o editor confirme que fechá-la não cancela a operação do servidor.
  • Use uma sessão separada para inspecionar pg_stat_activity e pg_blocking_pids() quando tiver permissão.
  • Cancele apenas a instrução pretendida. Não encerre a sessão de outro usuário sem autorização explícita.
  • Após uma interrupção do navegador ou da rede, verifique se uma instrução que altera dados foi confirmada antes de executá-la novamente.

O serviço pode pausar após o tempo ocioso. Uma aba aberta no editor não garante que uma sessão PostgreSQL permaneça utilizável indefinidamente.

Solucionar problemas no editor

Sintoma Resolução
Falha no login Atualize a sessão do Fabric, verifique a permissão do locatário e do espaço de trabalho e tente novamente uma vez.
Consulta falha com permissão negada Confirme que você é o criador do banco de dados, verifique a propriedade do objeto e verifique se a operação é suportada.
A relação não existe Verifique o banco de dados, o esquema, a ortografia e as maiúsculas/minúsculas do identificador entre aspas.
O explorador de objetos não mostra uma nova tabela Faça o commit do DDL, se necessário, e atualize o explorador.
Espera da consulta Verifique sessões de bloqueio, estado do ciclo de vida e se o banco de dados está sendo retomado.
Redefinições de conexão Reabra a consulta, inicie uma nova transação e reconcilie com segurança qualquer operação de gravação anterior.
Uma consulta funciona no endpoint PostgreSQL, mas não no endpoint de análise SQL Os endpoints possuem motores, permissões, atualização e operações suportadas diferentes.