Como usar
- Cole a instrução em SQL. O layout é feito enquanto você digita.
- Escolha um Recuo de 2 ou 4 espaços para o layout.
- Marque Minificar: tudo em uma linha se a instrução precisar ser uma só linha, para um arquivo de configuração ou um log.
- Copie o SQL formatado, ou baixe-o como formatted.sql.
Como o layout é feito
O formatador lê o texto como tokens: palavras, números, strings, nomes entre aspas, comentários, operadores e pontuação. As palavras da lista de palavras-chave do SQL são escritas em maiúsculas, e o resto, inclusive os nomes, mantém a grafia que tinha. Uma cláusula como SELECT, FROM, WHERE, GROUP BY, HAVING ou ORDER BY começa uma nova linha, e seu conteúdo fica um nível abaixo dela.
Dentro de SELECT, FROM, GROUP BY, ORDER BY, SET e VALUES, cada vírgula começa uma nova linha. AND e OR começam uma linha abaixo de WHERE, HAVING e ON. Um join como LEFT OUTER JOIN começa uma linha abaixo de FROM, e a condição ON dele fica nessa linha. Uma subconsulta entre parênteses é recuada um nível a mais que a linha em que o parêntese está, e o parêntese de fechamento se alinha com essa linha.
- Strings com aspas duplicadas, identificadores entre aspas duplas, crases ou colchetes, e textos entre $$ são mantidos exatamente.
- Comentários de linha e de bloco são mantidos. Quando o layout é minificado, um comentário de linha vira um comentário de bloco para que a instrução possa ficar em uma linha.
O que o formatador não faz
O formatador não interpreta a instrução, então não verifica se o SQL é válido e não muda o que ela significa. Ele não conhece as regras de um banco de dados específico, então uma palavra que é especial em um dialeto e um nome comum em outro é escrita em maiúsculas nos dois casos. Confira o resultado com o seu próprio banco de dados antes de usá-lo em produção.
Exemplo resolvido: uma consulta de relatório
A instrução padrão seleciona o id e o nome dos usuários ativos com o número de pedidos deles, agrupa-os e ordena pela contagem. Formatada com dois espaços, a lista de seleção tem uma coluna por linha, cada cláusula começa a sua própria linha, e LIMIT 10 é a última linha.
Minificada, a mesma instrução é uma linha só, com espaços simples entre as palavras. A contagem mostra 1 instrução.
Perguntas frequentes
Qual dialeto de SQL o formatador aceita?
Ele funciona para as partes que a maioria dos dialetos compartilha, como SELECT, INSERT, UPDATE, DELETE, joins, subconsultas e CASE. Aceita os estilos de aspas de MySQL, PostgreSQL, SQL Server e SQLite, mas não confere a sintaxe específica de cada dialeto.
Formatar muda o resultado da minha consulta?
Não. Só mudam os espaços, as quebras de linha e a caixa das palavras-chave. Nomes, strings, números e comentários são mantidos exatamente, então a instrução significa a mesma coisa.
Por que uma palavra do nome da minha tabela ou coluna ficou em maiúsculas?
A palavra está na lista de palavras-chave, como USE ou ORDER, então é escrita em maiúsculas onde quer que apareça. Nomes que não estão na lista são mantidos exatamente. Coloque esse nome entre aspas duplas ou crases para mantê-lo como foi digitado.
Por que um comentário de linha vira um comentário de bloco na minificação?
Um comentário de linha termina no fim da sua linha, então em uma linha só ele esconderia o resto da instrução. O comentário de bloco mantém o texto e não esconde o código depois dele.
O meu SQL é enviado para algum servidor?
Não. A formatação roda no seu navegador. Nada do que você cola é enviado para o nosso servidor nem guardado lá, o que importa quando a instrução contém dados privados.
Fontes
- Documentação do PostgreSQL (em inglês): SQL syntax, lexical structure
- Documentação do SQLite (em inglês): SQL keywords
Números e texto verificados pela última vez em terça-feira, 10 de novembro de 2026.