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.
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
Abra o banco de dados HorizonDB no portal Fabric.
Selecione Nova Consulta.
Confirme que o editor tem como alvo o banco de dados operacional, e não o endpoint de análise SQL.
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 BYquando a ordem de linhas for relevante. - Adicione uma cláusula seletiva
WHEREe umLIMITrazoá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:
- Atualize o esquema ou grupo de objetos relevante.
- Expanda o schema pertencente ao cliente.
- Inspecionar colunas, restrições e índices.
- 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_activityepg_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. |