Formatador SQL

Embeleze, minifique ou formate consultas SQL para qualquer dialeto

Dialeto

Recuo

Palavras-chave em maiúsculas

Como funciona

Formatador SQL — Embeleze, minifique ou formate consultas SQL para qualquer dialeto. Todo o processamento acontece no seu navegador — sem upload, sem cadastro, sem e-mail. Grátis para sempre.

Última atualização: 2026-05-06

Editor's note

Usamos isso em logs de produção onde alguém embutiu uma query de 400 caracteres num campo string e a gente precisa lê-la antes que a ponte do incidente lote. O dropdown de dialeto não é um detalhe de polimento — é o ponto inteiro. O `RETURNING` do PostgreSQL, identificadores com crase do MySQL, aspas com colchetes do T-SQL e o `QUALIFY` do BigQuery têm cada um seu próprio conjunto de palavras-chave, e escolher o dialeto errado produz uma saída que parece ok, compila na sua cabeça, e aí falha no instante em que você cola no psql. Somos obcecados por chegar no dialeto certo por padrão porque "parece formatado" e "está formatado corretamente" não são a mesma coisa.

Recusamos subir sua query, mesmo sendo marginalmente mais fácil rodar o formatter no servidor. SQL de produção é a string que mais revela schema no seu codebase — nomes de tabela, nomes de coluna, regra de negócio, e às vezes os IDs literais de cliente que você estava depurando. Não existe versão de "prometemos que não vamos logar" em que confiamos, então rodamos o sql-formatter no navegador e fim de conversa. Se a troca fosse formatação mais clara em troca do seu schema no pipeline de outra pessoa, ainda escolheríamos o navegador toda vez.

Sobre Formatador SQL

Colar uma query SQL de 500 linhas que chegou como uma string contínua não é jeito de depurar um relatório lento. Este formatador SQL faz pretty-print de qualquer query com indentação consistente, palavras-chave em maiúscula e cláusulas alinhadas, para que JOIN, WHERE, GROUP BY e expressões CASE fiquem instantaneamente legíveis. É a mesma biblioteca (sql-formatter) que está por trás de plugins populares de IDE, exposta como uma ferramenta que você acessa sem instalar nada.

Escolha o dialeto que combina com seu banco para obter o reconhecimento de palavras-chave mais preciso: SQL Padrão, MySQL, PostgreSQL, SQLite, MariaDB, T-SQL (SQL Server), BigQuery, Redshift, Snowflake e Trino são todos suportados. O dialeto importa porque cada engine tem palavras reservadas, regras de quoting de identificadores e funções nativas que os outros não têm — formatar com o dialeto certo mantém seus nomes de CTE, expressões de path JSON e palavras-chave específicas do dialeto com a aparência correta.

A formatação só ajusta espaços em branco e capitalização. Identificadores, literais, comentários e a semântica real da query são preservados exatamente — então a saída formatada produz resultados idênticos aos da original. E como tudo roda localmente no seu navegador, a query (que frequentemente contém nomes reais de schema, IDs e lógica de negócio) nunca atravessa a rede.

Como usar Formatador SQL

Cole sua query SQL (em uma linha ou em várias) na caixa de entrada.
Escolha o Dialeto que combina com seu banco para tratamento preciso de palavras-chave e identificadores.
Defina a Indentação (2 ou 4 espaços são típicos) para combinar com o estilo do seu time.
Ative "Maiúsculas em palavras-chave" se seu style guide capitaliza SELECT, FROM, JOIN.
Clique em Formatar para um layout legível, ou em Minificar para colapsar a query em uma linha para embutir em código.
Copie o resultado para seu editor, script de migração ou code review do pull request.

Casos de uso comuns

Limpar uma query que chegou como uma única linha em uma entrada de log ou em uma resposta de API JSON.
Padronizar SQL dentro de um code review para que os revisores enxerguem a mudança de lógica real, e não ruído de formatação.
Reformatar SQL gerado automaticamente por um ORM em algo que um humano consegue depurar para performance.
Minificar uma query antes de embutir como string literal no código da aplicação, e formatar de volta na hora de depurar.
Produzir queries-alvo de EXPLAIN legíveis para um runbook ou postmortem de incidente.

Dicas e erros comuns

Se palavras-chave como "QUALIFY" ou "PIVOT" não forem capitalizadas, você provavelmente escolheu o dialeto errado — elas só são reconhecidas como palavras-chave em BigQuery / Snowflake / T-SQL respectivamente.
Ponto-e-vírgula final e comentários são preservados. Se sua ferramenta downstream rejeitar, remova depois de formatar.
A formatação não conserta erro de sintaxe. Se uma query se recusa a formatar, passe pelo parser do seu banco antes para encontrar o parêntese ou vírgula faltando.
Para queries muito longas, a formatação é mais útil quando as palavras-chave ficam alinhadas e você indenta generosamente (4 espaços) — legibilidade ganha de compactação assim que uma query deixa de caber em uma tela.

Perguntas frequentes

Quais dialetos SQL são suportados?

SQL padrão mais MySQL, PostgreSQL, SQLite, MariaDB, T-SQL (SQL Server), BigQuery, Redshift, Snowflake e Trino. Escolha o dialeto para o tratamento mais preciso de palavras-chave e identificadores.

Minha consulta é enviada ao seu servidor?

Não. A formatação roda inteiramente no seu navegador com a biblioteca sql-formatter. A consulta nunca sai do dispositivo.

Vai mudar o sentido da minha consulta?

Não — o formatador apenas ajusta espaços e maiúsculas. A semântica SQL, identificadores e literais de string são preservados exatamente.

Posso formatar sintaxe específica de dialeto como operadores JSON do PostgreSQL ou literais STRUCT do BigQuery?

Sim — escolha o dialeto correspondente e operadores como ->>, #>>, [].* e STRUCT(...) mantêm seu significado. A formatação só re-alinha espaços em branco; nunca reescreve operadores ou tipos.

O formatador valida se o SQL está correto?

Só superficialmente. Ele faz parsing o suficiente para saber onde cláusulas começam e terminam, mas não é um parser SQL completo — queries inválidas ainda podem sair "formatadas". Use o EXPLAIN ou um dry-run do seu banco para validação real.

O Minificar produz uma query mais curta que minha versão escrita à mão em uma linha?

Geralmente sim — ele tira espaços em branco redundantes, normaliza vírgulas e remove linhas em branco, mas preserva comentários a menos que você os apague. Útil quando você precisa da query como string em uma única linha no código.