Por Carlos Zucolli | Especialista em Tecnologia para o Varejo
Formatador de SQL
Cole o SQL minificado ou mal formatado, escolha o dialeto e obtenha o código identado e legível instantaneamente. 100% no navegador.
Por que formatar SQL?
SQL gerado por ORMs, copiado de logs ou escrito rapidamente costuma estar em uma linha só, sem indentação. Um SQL bem formatado facilita revisão de código, depuração de queries complexas, e comunicação entre membros da equipe.
Dialetos suportados
A biblioteca sql-formatter suporta os principais dialetos: SQL padrão ANSI, MySQL, PostgreSQL, T-SQL (SQL Server), PL/SQL (Oracle), BigQuery, MariaDB, Redshift e Spark SQL. Cada dialeto tem palavras-chave e funções específicas que são reconhecidas corretamente.
Opções de formatação
Indentação — escolha entre 2 espaços, 4 espaços ou tab para se alinhar ao estilo do seu projeto. Palavras-chave em maiúsculas — convenção amplamente adotada que diferencia visualmente os comandos SQL dos identificadores e valores.
O que é o Formatador de SQL?
O Formatador de SQL é uma ferramenta essencial para desenvolvedores backend, DBAs e analistas que escrevem queries SQL. SQL mal formatado é difícil de ler, depurar e manter. A ferramenta formata automaticamente queries com indentação apropriada, palavras-chave em maiúsculas, alinhamento de cláusulas e quebras de linha. Suporta múltiplos dialetos: MySQL, PostgreSQL, T-SQL, PL/SQL, BigQuery e SQLite.
Como usar o Formatador de SQL?
Cole sua query SQL no campo de entrada. Selecione o dialeto do seu banco de dados se desejar (ou deixe em auto-detect). Clique em "Formatar" e a query é embelezada com indentação clara, keywords em UPPERCASE, e cláusulas alinhadas. Você pode also minificar para compactar queries e reduzir tamanho. Copie o resultado formatado para seu editor SQL ou aplicação.
Casos de uso práticos do Formatador de SQL
Queries SQL complexas com múltiplas JOINs, CTEs e WHEREs são praticamente ilegíveis sem formatação apropriada. Equipes de desenvolvimento usam formatadores para padronizar estilo de código. Performance debugging é mais fácil com queries bem formatadas. Analysts que compartilham queries com colegas enviam formatadas para legibilidade. Qualquer profissional que trabalha com SQL regularmente beneficia dessa ferramenta.
Como Usamos Isso na NuAto
Cenário: Padronização de Queries SQL de Relatórios de Campanha em Grande Rede de Atacarejo
Ao assumir a conta de uma grande rede de atacarejo, herdamos um repositório de relatórios SQL com mais de 340 queries desenvolvidas por 7 analistas diferentes ao longo de 3 anos. Cada analista tinha seu estilo: alguns usavam palavras-chave em maiúsculas, outros em minúsculas, indentação com 2 espaços, 4 espaços ou tabs, aliases de tabela criativos como t1, tbl ou sem alias algum. Queries críticas de apuração de performance de campanha estavam ilegíveis — uma delas tinha 180 linhas sem uma única quebra de linha consistente. Qualquer manutenção exigia reescrever mentalmente a lógica antes de entender o que a query fazia.
Estabelecemos o Formatador SQL como etapa obrigatória no processo de code review do time. Toda query nova ou modificada deveria ser formatada antes de ser submetida para revisão — sem exceção. Criamos um guia interno de 2 páginas com os padrões adotados (keywords em maiúsculas, indentação de 4 espaços, aliases descritivos como p para produtos e v para vendas, uma cláusula por linha no WHERE). As 340 queries do repositório legado foram formatadas em lotes durante um sprint dedicado, com cada analista responsável pelo seu conjunto histórico.
O impacto foi mensurável: o tempo médio de revisão de queries caiu de 22 minutos para 8 minutos por query. Dois bugs críticos foram descobertos durante a reformatação — uma query de comissão de vendedores com um LEFT JOIN que deveria ser INNER JOIN (gerando pagamento indevido de comissão) e uma query de inventário com um GROUP BY faltando que inflava os totais por fator 3x. Esses bugs existiam há meses no código não formatado e eram invisíveis na leitura rápida.
Para agências que entregam relatórios de BI e performance para varejistas, SQL não formatado é risco operacional real. Formatação consistente não é questão estética — é a diferença entre um bug que passa despercebido por meses e um que é capturado em revisão antes de ir para produção.