Português
Embeleze consultas SQL com indentação inteligente.
Última atualização
Um formatador de SQL pega aquela consulta espremida em uma linha só, gerada por ORM ou simplesmente bagunçada, e reescreve com indentação consistente e quebras de linha. Devs e analistas usam isso na hora de revisar joins, depurar filtros, limpar saída de ORM, compartilhar consultas em tickets ou na documentação, e ao analisar planos de execução passo a passo.
Formatar não muda *o que* a consulta faz — muda o quanto um humano consegue lê-la sem sofrer. Com o layout consistente, fica bem mais fácil enxergar a relação entre SELECT, FROM, JOIN, WHERE, GROUP BY, HAVING e ORDER BY, principalmente em consultas que misturam subconsultas e CTEs.
SQL tem vários *dialetos* — PostgreSQL, MySQL, SQLite, T-SQL (Microsoft SQL Server), Oracle e BigQuery estendem o padrão cada um do seu jeito. Um bom formatador entende o dialeto escolhido e não quebra a sintaxe específica de cada banco.
SELECT escolhe colunas, FROM escolhe tabelas, WHERE filtra linhas, GROUP BY agrupa e ORDER BY ordena.RETURNING, LIMIT, TOP e identificadores entre colchetes ([col] vs "col") não são portáveis entre os bancos.Jogue seu SQL na caixa de entrada. Pode ser de uma linha só, gerado por ORM ou já meio formatado — funciona do mesmo jeito.
Selecione PostgreSQL, MySQL, SQLite ou T-SQL para o formatador respeitar palavras-chave específicas como LIMIT, TOP ou RETURNING.
Defina o caso das palavras-chave (maiúsculas é o padrão) e a largura da indentação (2 ou 4 espaços). A maioria dos times usa palavras-chave em maiúsculas com indentação de 2 espaços.
Cada cláusula em sua própria linha, joins alinhados, subconsultas indentadas. Os comentários permanecem intactos.
Leve a consulta formatada para sua migration, query crua do ORM ou ferramenta de BI. Tudo acontece no seu navegador.
As cláusulas que aparecem em 95% das consultas SELECT, na ordem em que são processadas conceitualmente. Documentação oficial: SELECT no PostgreSQL, SELECT no MySQL.
| Cláusula | Para que serve | Exemplo |
|---|---|---|
SELECT | Define quais colunas/expressões retornar | SELECT id, name |
FROM | Define a(s) tabela(s) de origem | FROM users |
JOIN ... ON | Combina linhas de outra tabela | JOIN orders ON orders.user_id = users.id |
WHERE | Filtra linhas antes do agrupamento | WHERE active = true |
GROUP BY | Agrupa linhas que compartilham valores | GROUP BY country |
HAVING | Filtra grupos já agregados | HAVING COUNT(*) > 10 |
ORDER BY | Ordena o resultado | ORDER BY created_at DESC |
LIMIT / OFFSET | Pagina o resultado | LIMIT 20 OFFSET 40 |
WITH ... AS | Common Table Expression (CTE) — dá nome a uma subconsulta | WITH active AS (...) |
select id,name from users where active=true order by created_at desc limit 10SELECT id, nameFROM usersWHERE active = trueORDER BY created_at DESCLIMIT 10;Cada cláusula está em sua linha e a lista de colunas vem indentada. Revisar essa consulta em um code review acabou de ficar 10× mais fácil.
select u.name,o.total from users u join orders o on o.user_id=u.id where o.total>100SELECT u.name, o.totalFROM users uJOIN orders o ON o.user_id = u.idWHERE o.total > 100;Apelidar as tabelas (users u, orders o) deixa a lista de colunas enxuta. A linha do JOIN ... ON deixa explícita a relação entre as tabelas.
select * from users where id in (select user_id from enrollments where course_id=5)SELECT *FROM usersWHERE id IN ( SELECT user_id FROM enrollments WHERE course_id = 5);Indentar a consulta interna deixa a dependência clara. Várias subconsultas podem ser reescritas como JOINs ou CTEs assim que você consegue enxergar a estrutura.
LIMIT 10 no PostgreSQL, TOP 10 no T-SQL e FETCH FIRST 10 ROWS ONLY no SQL padrão fazem a mesma coisa.SELECT, FROM, WHERE) e identificadores em minúsculas, porque o contraste visual destaca a estrutura da consulta. Escolha um estilo e mantenha a consistência.