Abrir e executar SQL no QueryConsole

Host e porta bastam para abrir: o banco é opcional e pode ser escolhido pela árvore lateral. Veja os painéis, a execução e o que conferir antes.

O QueryConsole executa SQL em um banco PostgreSQL, mostra o resultado em tabela e permite exportar ou editar os dados retornados.

Para que serve

• consultar dados para conferir uma restauração;
• localizar um registro específico;
• conferir se uma tabela tem o conteúdo esperado;
• exportar um resultado para planilha.

O que precisa estar pronto

Menos do que parece:

O PostgreSQL precisa estar ativo naquela porta. Se não estiver, o console não abre; veja PostgreSQL não aparece.

Como abrir

1. Abra Restaurar o Banco de Dados.
2. Preencha Host e Porta.
3. Preencha Banco de Dados — ou deixe em branco para escolher depois.
4. Pressione Alt+P.
5. Aguarde o console carregar.

Se faltar algo obrigatório, o RestauraDB lista exatamente o que preencher antes de abrir.

O que acontece ao abrir

A janela abre e carrega o catálogo do banco — a lista de objetos que aparece na árvore lateral. Enquanto esse carregamento acontece, a execução fica bloqueada e a barra de status avisa. Isso é normal e dura poucos instantes.

As áreas da janela

Ampliar

Quando uma consulta retorna linhas, elas aparecem em Data Output. Quando não retorna linhas — ou quando há aviso —, a informação útil está em Messages.

Botões da barra

• Abrir — abre um arquivo .sql no editor
• Salvar — salva o SQL do editor em arquivo
• Atualizar — recarrega o catálogo e a árvore
• Executar — executa o SQL
• Limpar — limpa a saída
• Exportar — exporta o resultado
• + — abre uma nova aba de consulta

Cada aba tem seu próprio SQL e seu próprio resultado.

Como executar

1. Digite a consulta no editor.
2. Para rodar apenas um trecho, selecione o trecho.
3. Clique em Executar ou pressione F5.
4. Veja o resultado em Data Output.

Com texto selecionado, executa somente a seleção; sem seleção, executa o editor inteiro. Os detalhes estão em Atalhos do QueryConsole.

Como saber que executou

• Data Output traz as linhas do resultado;
• o rodapé mostra o total de linhas e a conclusão;
• Messages registra avisos, quando houver.

Se nada mudar após acionar, provavelmente já havia uma execução em andamento ou o catálogo ainda estava carregando — a barra de status informa.

Executar SQL não é o mesmo que editar resultado

O que pode dar errado

Uma consulta com erro não significa que o console está com problema — se a mensagem fala de tabela, coluna ou sintaxe, a conexão está funcionando.

Quando procurar suporte

Procure suporte quando:

• o console não abre mesmo com PostgreSQL ativo na porta;
• a árvore de objetos não carrega;
• uma consulta simples não retorna nada onde deveria haver dados.

Informe o código exibido, a porta e o banco conectado. Não envie senhas nem o conteúdo das consultas sem orientação.

Artigos relacionados

• Atalhos do QueryConsole
• Editar dados no Data Output
• Por que o QueryConsole não conecta
• Por que o PostgreSQL não aparece
• RDB-SQL-001 — Não foi possível abrir o console
• RDB-SQL-002 — A consulta falhou
• RDB-SQL-004 — Falha ao exportar o resultado
• RDB-SQL-005 — Falha ao abrir ou salvar o arquivo SQL