Escrever queries

Abra uma aba de query com ⌘ T. O que você digita fica salvo como rascunho daquela conexão e volta na próxima vez.

Rodando

⌘ ↵ roda:

• a seleção, se você selecionou algo;
• senão, o comando onde está o cursor, quando a aba tem vários (o botão diz Executar comando);
• senão, a aba inteira.

Para rodar um script inteiro, selecione tudo e aperte ⌘ ↵, ou use Criar… › Rodar arquivo SQL… na barra lateral.

Parar cancela uma query rodando. Por padrão as queries param depois de 30 segundos; mude em Ajustes › Dados e consultas › Tempo limite de consulta (0 desliga).

Cada comando que devolve linhas ganha uma aba de resultado própria, Result 1, Result 2 e assim por diante.

Rodar numa transação

⌥ ⌘ ↵ coloca tudo entre BEGIN e COMMIT. Se algum comando falha, todos voltam atrás. Só o último resultado aparece.

O ClickHouse não tem transação, então lá os comandos rodam um por um, sem rollback. No Trino depende do conector.

Parâmetros

Escreva :nome onde vai um valor:

SELECT * FROM orders WHERE customer_id = :customer AND status = :status

Antes de rodar, o Lily pede cada valor. Números entram como estão; o resto vai entre aspas. Casts do PostgreSQL como ::date não são confundidos com parâmetros, nem texto dentro de strings ou comentários. Em queries salvas, o Lily lembra os últimos valores.

Autocomplete

As sugestões aparecem depois de dois caracteres, ou quando você aperta Esc. Primeiro vêm as colunas das tabelas do seu FROM e JOIN, depois outras tabelas e colunas, depois palavras-chave SQL. Escolha com ↑ ↓ e ↵.

Snippets

Digite um gatilho e aperte Tab:

Gatilho	Vira
sel	SELECT * FROM
selw	SELECT * FROM … WHERE
cnt	SELECT COUNT(*) FROM
ins	INSERT INTO … VALUES
upd	UPDATE … SET … WHERE
del	DELETE FROM … WHERE
jl	LEFT JOIN … ON
ji	INNER JOIN … ON
grp	GROUP BY
ord	ORDER BY
lim	LIMIT
with	WITH cte AS (…)

Crie os seus em Ajustes › Biblioteca de queries › Snippets. Use $0 no modelo para marcar onde o cursor fica. Um gatilho seu com o mesmo nome substitui o embutido.

Formatando e editando

• ⇧ ⌘ F formata o SQL. Ajustes › Aparência › Formatar consulta automaticamente ao executar formata a query toda vez que você roda, menos quando roda uma seleção.
• ⌘ L comenta ou descomenta a linha.
• ⌥ ⌘ F busca texto no editor.
• ⌘ =, ⌘ - e ⌘ 0 dão zoom no editor. O tamanho padrão fica em Ajustes › Aparência.
• Aspas curvas viram retas enquanto você digita.

Arquivos SQL

⌘ O abre um arquivo .sql numa aba nova, e ⌥ ⌘ S salva a aba como arquivo.

Criar… › Rodar arquivo SQL… roda um script inteiro. Escolha Reverter tudo (uma transação) para rodar numa transação só, ou Continuar, reportando as falhas para rodar cada comando separado. Os comandos que falharem podem ser abertos no editor para corrigir. No ClickHouse cada comando sempre roda separado.

Quando uma query falha

O cartão de erro mostra a mensagem do servidor, com Copiar erro, Reconectar e, se a IA estiver configurada, Corrigir com IA. Quando um nome de tabela ou coluna parece digitado errado, o Lily sugere o certo.

Antes de uma escrita rodar

As escritas que você roda aqui são conferidas antes: o Lily conta as linhas que elas vão tocar, mostra algumas e pede confirmação. As mais arriscadas pedem para você digitar o nome da tabela. Veja Proteções.

A barra do editor também tem Explicar, o plano visual e o menu de IA. Veja EXPLAIN e queries lentas e IA no editor.