Formatação SQL e legibilidade

SQL longo é difícil de revisar quando vem copiado de logs ou gerado por ORM:

select u.id,u.email,o.total,case when o.total>100 then 'vip customer' else 'standard customer' end as segment from users u join orders o on o.user_id=u.id where o.created_at>='2026-01-01' and o.status in ('paid','refunded') order by o.created_at desc;

Formatar não torna a query correta, mas expõe estrutura:

• Colunas selecionadas viram lista.
• Blocos de join ficam visíveis.
• Ramos de CASE ficam legíveis.
• Filtros podem ser escaneados um a um.
• Ordenação e limites são mais fáceis de achar.

Hábitos úteis de formatação

Para depuração de aplicação, prefira consistência a gosto pessoal:

• Coloque cláusulas principais em linhas separadas.
• Indente expressões aninhadas e ramos de CASE.
• Mantenha condições de join perto dos joins.
• Use capitalização de keywords consistente dentro do projeto.
• Evite reformatar queries não relacionadas no mesmo PR, salvo se for intencional.

Minificar tem outro propósito

Minificar SQL remove espaço e comentários desnecessários para snippets compactos. Útil em arquivos de config, exemplos copiados ou testes em que uma linha é mais fácil de embutir.

Não minifique SQL que humanos precisam revisar durante um incidente. Use formatação legível enquanto depura.

Conclusão

Formatação é ferramenta de pensamento. Transforma string densa em estrutura que você pode inspecionar, discutir e alterar com segurança.

Abra o Formatador SQL e compare Format vs Minify na mesma query para ver qual versão serve para revisão ou embutir.