Ferramenta 22 · Banco de dados

Formatador de SQL

Transforme uma consulta de uma linha só em um texto legível, com cada cláusula no seu lugar. A ferramenta só muda espaços e a caixa das palavras-chave, e confere sozinha que o comando continua o mesmo.

SQL de entrada

Cole sua consulta

Indentação

Palavras-chave em MAIÚSCULAS

Cole um SQL e clique em Formatar.

SQL formatado

Para que serve

Consultas geradas por ferramentas, copiadas de logs ou escritas às pressas costumam ficar em uma linha única, difíceis de revisar. Formatar deixa a estrutura visível: onde começa o FROM, quais condições estão no WHERE, qual JOIN liga qual tabela. Isso ajuda a achar erros, comparar versões e documentar.

O que a ferramenta faz

Coloca SELECT, FROM, WHERE, GROUP BY, HAVING, ORDER BY, UNION e os JOIN (com seus ON) cada um na sua linha.
Quando há mais de uma coluna no SELECT (ou mais de uma atribuição no SET), escreve uma por linha.
Quebra as linhas de AND e OR, mas mantém o AND do BETWEEN junto da condição.
Recua subconsultas entre parênteses, expressões CASE e listas de VALUES.
Deixa funções e listas curtas na mesma linha: COUNT(*), IN (1, 2, 3).

A garantia de segurança

Formatar nunca deve mudar o que a consulta faz. Por isso a ferramenta só altera espaços, quebras de linha e a caixa das palavras-chave; textos entre aspas, identificadores, números, comentários e operadores são preservados exatamente. Depois de formatar, ela refaz a leitura do resultado e compara, símbolo por símbolo, com o original. Se houver qualquer diferença, o resultado não é entregue e você vê uma mensagem de erro. Em testes automáticos, isso foi verificado com milhares de combinações aleatórias de símbolos, comentários e textos.

Não é um validador. A ferramenta não executa a consulta, não conhece o seu banco e não aponta erros de SQL. Um SQL inválido sai formatado e continua inválido. Os dialetos mais comuns (SAP HANA, SQL Server, PostgreSQL, MySQL, Oracle) funcionam para consultas e para INSERT, UPDATE e DELETE simples; blocos procedurais, CREATE TABLE longos e sintaxes muito específicas são apenas reespaçados, sem layout especial.

Como usar

Cole a consulta.
Escolha a indentação e se quer as palavras-chave em maiúsculas.
Clique em Formatar e copie o resultado.

Perguntas frequentes

Por que meus nomes de função não ficaram em maiúsculas?

Só as palavras reservadas mais comuns são alteradas (SELECT, FROM, JOIN...). Nomes de funções e de colunas ficam como você digitou, para nunca trocar o nome de um objeto que diferencia maiúsculas de minúsculas.

Os comentários são mantidos?

Sim, tanto -- linha quanto /* bloco */. Um comentário de linha sempre termina a linha onde está.

Recebi "Verificação de segurança falhou"

Significa que a formatação alteraria algum símbolo da consulta, o que a ferramenta recusa por princípio. Isso é raro e costuma acontecer com sintaxes pouco comuns, como colchetes com várias palavras fora do padrão [nome da coluna].

Privacidade e limites

O SQL é processado no seu navegador e não é enviado a servidor. Mesmo assim, evite colar consultas com senhas, chaves ou dados reais de clientes em qualquer ferramenta online. O limite é de 500 mil caracteres.