Guias de formatação SQL
Guias práticos para escrever SQL que as pessoas consigam ler, revisar e manter: convenções de estilo, consultas complexas, fluxo de trabalho em equipe e diferenças entre dialetos. Todos os exemplos formatados destas páginas foram gerados pelo próprio motor do SQL Format.
- Guia de estilo SQL Nomenclatura, caixa das palavras-chave, indentação, aliases, JOINs explícitos, comentários e CTEs: um conjunto pragmático de convenções que uma equipe consegue manter de verdade.
- Como formatar consultas SQL complexas CTEs, subconsultas aninhadas, CASE, funções de janela e UNION: como organizar consultas que ocupam uma tela inteira ou mais.
- Vírgulas à esquerda ou à direita em SQL Uma comparação aprofundada dos dois estilos de vírgula: diffs, colunas comentadas, leitura rápida e os erros que cada estilo evita.
- Formatação de SQL para code review e controle de versão Como uma formatação consistente mantém os diffs limpos, como implantar um padrão na equipe e como revisar SQL em pull requests.
- Erros comuns de legibilidade em SQL Joins implícitos, SELECT *, aliases de uma letra, AND/OR misturados e mais: hábitos frequentes que dificultam a leitura de SQL e como corrigi-los.
- Formatação de consultas PostgreSQL e PL/pgSQL Casts, parâmetros, RETURNING, ON CONFLICT e corpos PL/pgSQL com dollar quoting: o que o formatador faz com a sintaxe do PostgreSQL.
- Diferenças entre dialetos SQL que afetam a formatação Aspas em identificadores, LIMIT vs FETCH FIRST vs TOP, separadores de lote e blocos procedurais nos principais bancos de dados.
- Checklist de formatação SQL antes de implantar uma migration Um checklist curto para rodar antes que uma migration de schema ou de dados vá para revisão e produção.