Formatador de SQL

Deixe seu SQL legível de novo

O SQL copiado de logs, ORMs, ferramentas de BI ou da mensagem de um colega costuma chegar em uma única linha longa: select u.id,u.name,count(o.id) from users u left join orders o on o.user_id=u.id where u.active=1 group by u.id order by 3 desc. O formatador de SQL quebra em linhas, coloca cada cláusula (SELECT, FROM, JOIN, WHERE, GROUP BY, ORDER BY) no lugar e adiciona recuo para você acompanhar a lógica.

SQL legível é mais fácil de depurar, revisar e documentar. Achar uma condição de join faltando ou um WHERE no lugar errado é muito mais rápido quando a consulta está organizada.

Funciona com SQL padrão como o usado por MySQL, MariaDB, PostgreSQL, SQLite, SQL Server e outros.

Como usar o formatador de SQL

1. Cole sua consulta SQL.
2. Envie para formatar.
3. Leia ou copie o SQL formatado.

Exemplos

Uma consulta de relatório em uma linha

Entrada:

select u.id, u.name, count(o.id) as orders from users u left join orders o on o.user_id = u.id where u.active = 1 group by u.id, u.name order by orders desc limit 10

Resultado:

select
  u.id,
  u.name,
  count(o.id) as orders
from
  users u
  left join orders o on o.user_id = u.id
where
  u.active = 1
group by
  u.id,
  u.name
order by
  orders desc
limit
  10

Cada cláusula vai para a própria linha e cada coluna ganha recuo. As palavras-chave mantêm as maiúsculas ou minúsculas que você digitou.

Um update

Entrada: UPDATE products SET price = price * 1.1 WHERE category_id IN (3, 7);

Resultado:

UPDATE
  products
SET
  price = price * 1.1
WHERE
  category_id IN (3, 7);

Usos comuns

• Ler consultas capturadas nos logs da aplicação ou na depuração do ORM.
• Preparar SQL para revisões de código e pull requests.
• Escrever documentação e tutoriais com exemplos claros.
• Depurar consultas longas com muitos joins e subconsultas.
• Organizar consultas antes de salvá-las em uma ferramenta de BI ou um notebook.
• Ler consultas copiadas dos logs da aplicação, onde costumam estar em uma única linha.

Dicas e coisas para saber

• A formatação só muda os espaços. Ela não valida o SQL nem muda os resultados.
• Remova dados reais de clientes e senhas das consultas antes de colar em qualquer site on-line.
• Escolha um estilo único para a sua equipe, como palavras-chave em maiúsculas e uma coluna por linha.
• Mude o estilo dos identificadores com o conversor de maiúsculas e minúsculas e formate resultados JSON com o formatador de JSON.

Casos especiais e limitações

• As palavras-chave não são passadas para maiúsculas. Se o estilo da sua equipe usa maiúsculas, escreva assim.
• Várias instruções separadas por ponto e vírgula são formatadas uma depois da outra.
• Os comentários são mantidos. Strings e identificadores entre aspas não são alterados.

Perguntas frequentes

A formatação muda o que minha consulta faz?

Não. Só mudam os espaços e as quebras de linha, então a consulta retorna os mesmos resultados.

Quais dialetos de SQL são aceitos?

As palavras-chave de SQL padrão usadas por MySQL, PostgreSQL, SQLite, SQL Server e bancos de dados parecidos são bem formatadas.

Ele verifica se meu SQL tem erros?

Não. Ele formata o texto; execute a consulta no seu banco de dados para encontrar erros.

As palavras-chave de SQL devem ficar em maiúsculas?

Não é obrigatório, mas palavras-chave em maiúsculas são uma convenção comum que deixa as consultas mais fáceis de percorrer com os olhos.

Ferramentas relacionadas

• Validador e formatador de JSON: Valide conteúdo JSON e deixe-o em um formato legível.
• Conversor de maiúsculas e minúsculas: Converta seu texto para minúsculas, MAIÚSCULAS, camelCase e outros formatos.
• Minificador de JS: Minifique seu JS removendo todos os caracteres desnecessários.
• Conversor de entidades HTML: Codifique ou decodifique entidades HTML de qualquer texto.
• Separador de texto: Separe texto nos dois sentidos por quebras de linha, vírgulas, pontos etc.