Como usar: Formatador SQL
- Cole uma ou mais instruções SQL em SQL de entrada (ou abra um arquivo
.sql). - Selecione o seu dialeto — isso importa para coisas como identificadores com crase no MySQL, casts
::no PostgreSQL ouTOPno SQL Server. - Escolha a caixa das palavras-chave e a indentação. A query formatada é atualizada enquanto você digita.
- Copie o resultado ou baixe como
query.sql.
O que um formatador de SQL faz?
SQL não se importa com espaços em branco, então queries geradas por ORMs, registradas em logs do banco ou escritas com pressa acabam muitas vezes numa linha gigantesca. Um formatador de SQL analisa a instrução e a reescreve com cada cláusula principal — SELECT, FROM, JOIN, WHERE, GROUP BY, ORDER BY — começando em uma nova linha, com as listas de colunas indentadas embaixo e as subqueries aninhadas um nível a mais. Isso facilita muito encontrar uma condição de join esquecida, um OR mal posicionado ou uma coluna que faltou no group by.
Exemplo
select u.id, 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
vira
SELECT
u.id,
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
Por que a configuração de dialeto importa
Cada banco estende o SQL de um jeito diferente. Escolher o dialeto certo permite que o formatador reconheça palavras-chave e sintaxes específicas de cada fornecedor, em vez de tratá-las como erro:
| Dialeto | Exemplos que ele entende |
|---|---|
| MySQL / MariaDB | identificadores com `crase`, LIMIT 10, 20, ON DUPLICATE KEY UPDATE |
| PostgreSQL | casts ::, parâmetros $1, RETURNING, corpos de função entre aspas de dólar |
| SQL Server (T-SQL) | nomes entre [colchetes], TOP (10), @variáveis, lotes com GO |
| BigQuery | tipos STRUCT/ARRAY, caminhos project.dataset.table entre crases, QUALIFY |
| Oracle PL/SQL | variáveis :bind, CONNECT BY, strings q'[…]' |
Se uma query falhar com erro de parse, a causa mais comum é um dialeto diferente do correto — tente selecionar o banco que você realmente usa. O formatador é baseado na biblioteca de código aberto sql-formatter e roda inteiramente no seu navegador, então queries de produção com dados de clientes nunca saem da sua máquina.
Caixa das palavras-chave: maiúsculas ou minúsculas?
Palavras-chave em MAIÚSCULAS são a convenção tradicional e destacam a estrutura da query em relação a nomes de tabelas e colunas; muitos times modernos preferem minúsculas por serem mais fáceis de digitar e ler. Escolha uma e mantenha a consistência — linters como o SQLFluff podem forçar isso no CI. A opção Funções controla separadamente funções nativas como count() ou coalesce().
Quer comparar duas versões de uma query? Cole-as no Comparador de Diferenças. Exportou resultados em JSON? Transforme-os em planilha com JSON para CSV.
Também pesquisado como: formatar sql online, beautifier sql, identar sql, deixar sql bonito, organizar query sql, formatador de query mysql, formatar código sql postgresql, sql pretty print.
Ferramentas que combinam com: Formatador SQL
- Formatação JSON — Cole o JSON aqui para formatá-lo, compactá-lo ou validá-lo.
- CSV para JSON — Cole um CSV ou TSV e receba um array JSON de objetos.
- Formatador JavaScript — Desminifique e deixe legível JavaScript, JSON ou JSX com a indentação e o estilo de chaves que você preferir, ou remova espaços e comentários com um minificador verificado.
- Formatador HTML — Cole HTML minificado ou bagunçado e receba um código limpo e com indentação consistente, incluindo os blocos <style> e <script> embutidos.
Perguntas frequentes
O formatador muda o que a minha query faz?
Por que recebo um erro de parse?
{{ var }} também podem confundi-lo.Consigo formatar várias instruções de uma vez?
É seguro colar queries de produção?
WHERE permanecem privados.Stored procedures e DDL são suportados?
CREATE TABLE, ALTER, INSERT, CTEs (WITH) e window functions são totalmente suportados. Blocos procedurais (PL/pgSQL, fluxo de controle do T-SQL) são formatados com base no melhor esforço.