Consulta do Editor de SQL do Lakebase

O Editor de SQL do Lakebase executa consultas em seus bancos de dados do Lakebase diretamente do Aplicativo Lakebase. Ele oferece recursos nativos do Postgres, como EXPLAIN/ANALYZE, psql-style meta-comandos e a exportação de resultados para CSV/JSON/XLSX.

Usar o Editor de SQL do Lakebase

Para usar o Editor de SQL:

1. Abra o Aplicativo Lakebase e selecione seu projeto.
2. Selecione o Editor de SQL na barra lateral e selecione um branch e um banco de dados.
3. Insira uma consulta no editor e clique em Executar para exibir os resultados.

Use a consulta a seguir para experimentar o Editor de SQL. A consulta cria uma tabela, adiciona dados e recupera os dados da tabela.

CREATE TABLE IF NOT EXISTS playing_with_lakebase(id SERIAL PRIMARY KEY, name TEXT NOT NULL, value REAL);
INSERT INTO playing_with_lakebase(name, value)
SELECT LEFT(md5(i::TEXT), 10), random() FROM generate_series(1, 10) s(i);
SELECT * FROM playing_with_lakebase;

Executar várias instruções de consulta ao mesmo tempo retorna um conjunto de resultados separado para cada instrução. Os conjuntos de resultados são exibidos em guias separadas, numeradas em ordem de execução.

Para limpar o editor, selecione o conteúdo da caixa de texto e exclua-o.

Explicar e analisar

O Editor de SQL do Lakebase tem recursos De explicação e análise .

• O recurso Explicar executa a consulta especificada com o comando Postgres EXPLAIN , que retorna o plano de execução da consulta. O recurso Explicar retorna apenas um plano com estimativas. Ele não executa a consulta.
• O recurso Analisar executa a consulta especificada com EXPLAIN ANALYZE. O parâmetro ANALYZE executa a consulta e retorna a contagem real de linhas e os tempos de execução para os nós do plano, juntamente com as estimativas de EXPLAIN.

Entender as informações fornecidas pelos recursos Explicar e Analisar requer familiaridade com o comando Postgres EXPLAIN e seu ANALYZE parâmetro. Consulte a documentação em EXPLAIN e Como usar EXPLAIN na documentação do PostgreSQL.

Exportar dados para CSV, JSON e XLSX

O Editor de SQL do Lakebase dá suporte à exportação de seus dados para JSON, CSVe XLSX. Acesse o botão de download no canto inferior direito da página Editor SQL. O botão de download só é exibido quando há um conjunto de resultados a ser baixado.

Expandir a seção de resultados da janela do editor do SQL

Expanda a seção de resultados da janela do Editor do SQL selecionando o botão expandir janela no canto inferior direito da página editor do SQL .

Metacomandos

O Editor de SQL do Lakebase dá suporte ao uso de metadados do Postgres, que atuam como atalhos para interagir com seu banco de dados. Se você já estiver familiarizado com o uso de metadados da psql interface de linha de comando, poderá usar muitos desses mesmos comandos no Editor de SQL do Lakebase.

Os metadados podem acelerar seu fluxo de trabalho fornecendo acesso rápido a esquemas de banco de dados e outras informações críticas sem a necessidade de gravar consultas SQL completas.

Aqui estão alguns metadados comumente usados no Editor de SQL do Lakebase:

• \dt — Listar todas as tabelas no banco de dados atual
• \d [table_name] — Descrever a estrutura de uma tabela
• \l — Listar todos os bancos de dados
• \? — Um guia rápido dos meta-comandos disponíveis
• \h [NAME] — Obtenha ajuda para qualquer comando postgres (por exemplo, \h SELECT)

Para obter uma lista completa de metadados e seu uso, consulte Metadados no psql.

Como usar metadados

Para usar um metadado no Editor de SQL, insira o metadado no editor (assim como uma consulta SQL) e clique em Executar. O resultado será exibido no painel de saída.

Limitações do Editor de SQL quando o acesso público é desabilitado

Quando seu workspace está com o Link Privado configurado e o acesso público desabilitado, o SQL Editor encaminha as consultas por meio do backend do Lakebase em vez de usar uma conexão direta com o banco de dados. A maioria das consultas funciona de forma idêntica a uma conexão direta, mas o proxy é sem estado e executa cada instrução como uma solicitação HTTP independente, o que apresenta as seguintes limitações:

O que funciona:

• Consultas de instrução única (SELECT, INSERT, UPDATE, DELETE, UPSERT)
• Instruções DDL (CREATE, ALTER, DROP TABLE, CREATE INDEX e outras)
• EXPLAIN e comandos DESCRIBE (\d, \dt, \di)
• Suporte completo aos tipos de dados do Postgres (arrays, JSON/JSONB, tipos numéricos, carimbos de data e hora, booleanos)
• Consultar resultados e mensagens de erro

O que não funciona:

Para cargas de trabalho que exigem transações ou estado de sessão, conecte-se diretamente ao banco de dados usando um cliente postgres. Consulte Conectar com psql.

Solução de Problemas

Se o Editor SQL exibir uma mensagem de "Failed to fetch" ou "Unknown error" e seu workspace utilizar um link privado, confirme se o link privado de entrada (nível de workspace, porta 443) está configurado corretamente. Consulte Solucionar problemas de conectividade do Link Privado.