Consulta do Editor SQL do Lakebase

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

Utilize o Editor SQL do Lakebase​

Para usar o Editor SQL:

1. Abra o aplicativo Lakebase e selecione seu projeto.
2. Selecione Editor SQL na barra lateral e, em seguida, selecione uma ramificação e um banco de dados.
3. Insira uma consulta no editor e clique em executar para view os resultados.

Use a seguinte consulta para experimentar o Editor 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 simultaneamente retorna um conjunto de resultados separado para cada instrução. Os conjuntos de resultados são exibidos em abas separadas, numerados na ordem de execução.

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

Explicar e analisar​

O Editor SQL Lakebase tem os **recursos** de **Explicação** e **Análise**.

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

Para entender a informação fornecida pelos recursos **Explain** e **Analyze**, é preciso ter familiaridade com o comando EXPLAIN do Postgres e seu ANALYZE parâmetro. Consulte a documentação EXPLAIN e Como usar o EXPLAIN na documentação do PostgreSQL.

Exportar dados para CSV, JSON e XLSX​

O Editor SQL do Lakebase oferece suporte à exportação de seus dados para JSON, CSV e XLSX. Acesse o botão de download no canto inferior direito da página **Editor SQL**. O botão de download aparece apenas quando há um conjunto de resultados para baixar.

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

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

Meta-comando​

O editor SQL do Lakebase suporta o uso de metacomandos do Postgres, que funcionam como atalhos para interagir com seu banco de dados. Se você já está familiarizado com o uso de meta-comandos da interface de linha de comando psql , você pode usar muitos desses mesmos comandos no Editor SQL do Lakebase.

O Meta-comando pode 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 escrever consultas SQL completas.

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

• \dt — Liste todas as tabelas no banco de dados atual
• \d [table_name] — Descreva 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 do Postgres (por exemplo, \h SELECT)

Para obter uma lista completa dos meta-comandos e seus usos, consulte Meta-comando em psql.

Como usar o meta-comando​

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

Limitações do Editor SQL quando o acesso público está desativado​

Quando seu workspace tem o Private Link configurado com acesso público desabilitado, o Editor SQL encaminha as consultas pelo backend do Lakebase em vez de usar uma conexão de banco de dados direta. A maioria das consultas funciona de forma idêntica a uma conexão direta, mas o proxy é sem estado e realiza a execução de cada instrução como uma requisição HTTP independente, o que introduz 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 DESCRIBE comandos (\d, \dt, \di)
• Suporte completo a tipos de dados do Postgres (arrays, JSON/JSONB, numéricos, timestamps, booleanos)
• Resultados de consultas 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 seu banco de dados usando um cliente Postgres. Consulte Conecte-se com o psql.

Solução de problemas​

Se o SQL Editor exibir uma mensagem de "Falha ao buscar" ou "Erro desconhecido" e seu workspace usar o Private Link, confirme se o Private Link de entrada (nível do workspace, porta 443) está configurado corretamente. Consulte Solucionar problemas de conectividade do Private Link.