Esta página é o guia canónico para formatar e minificar SQL no Dev Tools Suite. Use o SQL Formatter interativo acima enquanto lê, ou salte para uma secção abaixo. Toda a análise e formatação corre no navegador via sql-formatter — consultas, nomes de esquema e dados de amostra nunca são carregados.

O SQL Formatter embeleza SQL multilinha para humanos e minifica SQL para transporte. Coloca palavras-chave em maiúsculas automaticamente (SELECT, FROM, WHERE), aplica indentação por cláusula e respeita gramática específica do dialecto da biblioteca sql-formatter — o mesmo motor usado por muitas extensões IDE e formatadores CLI.

O que obtém

• Espaço de trabalho dual simétrico: consulta SQL à esquerda, saída formatada ou minificada à direita
• 13 analisadores de dialecto agrupados como Núcleo relacional, Armazéns cloud, Big data e Empresa
• Modos Beautify e Minify com autoformatação em direto (com debounce) e botão Process explícito
• Seletor de dialecto e caixa Strip comments no cabeçalho do painel — sem linha extra
• Saída formatada recolhível para árvores SELECT grandes (modo Beautify)
• Erros de parse com indicações de linha e coluna quando o analisador não consegue ler a entrada
• Partilha de URL opcional: ?mode=minify&dialect=postgresql persiste modo e dialecto

Use esta ferramenta quando

• Cola SQL ad hoc de um log, ferramenta BI ou ORM e precisa de indentação legível antes da revisão
• Incorpora SQL em código de aplicação e quer uma string minificada numa linha
• Trabalha com PostgreSQL, Snowflake, BigQuery, Spark ou Oracle e precisa que o analisador reconheça palavras-chave do dialecto
• Quer remover comentários de bloco e linha antes de commit ou envio

Não espere

• Validação semântica — sucesso na formatação não significa execução no servidor
• Planeamento automático de consultas, lint de desempenho ou reescritas conscientes do esquema
• Preservação perfeita de cada extensão exótica não coberta pelo dialecto selecionado
• EXPLAIN ou execução no servidor — é apenas ferramenta de layout e espaços em branco

Os controlos ficam no cabeçalho do painel SQL QUERY para os editores de entrada e saída manterem a mesma altura. Não há linha de opções separada abaixo da barra de ferramentas.

Atalhos de teclado

• Ctrl/Cmd+Enter — Process
• Ctrl/Cmd+L — Limpar espaço de trabalho

Escolha sempre o dialecto que corresponde ao ambiente de execução. O analisador usa listas de palavras-chave, nomes de funções e regras de comentários distintas por dialecto. Standard SQL é um padrão seguro para fragmentos ANSI genéricos.

Cassandra CQL não é suportado — não faz parte do conjunto de dialectos sql-formatter. Use um formatador CQL específico para Cassandra.

Beautify e Minify partilham o mesmo seletor de dialecto e caixa Strip comments mas produzem formas de saída diferentes.

Exemplo

Entrada: select id, name from users where active = 1 — Beautify produz linhas indentadas com SELECT / FROM / WHERE em maiúsculas. Minify com Strip desligado produz uma linha: select id, name from users where active = 1.

1. Abra SQL Formatter na barra lateral em Formatters.
2. Cole SQL no editor esquerdo, carregue um ficheiro .sql da barra de sessão ou arraste um ficheiro para o estado vazio.
3. Escolha o dialecto da sua base de dados (ex. snowflake para consulta Snowflake).
4. Opcionalmente marque Strip comments se a entrada tiver anotações -- ou /* */ indesejadas.
5. Selecione Beautify para SQL legível ou Minify para linha compacta.
6. Revise a saída à direita. Corrija qualquer banner de erro de parse — clique para fechar após editar.
7. Copie, descarregue ou troque saída de volta para entrada para outra passagem.
8. Partilhe link com ?dialect=bigquery&mode=minify para colaboradores abrirem as mesmas definições.

Ficheiros de migração Flyway, Liquibase e ORM são mais fáceis de rever quando listas SELECT, blocos JOIN e cláusulas WHERE quebram em linhas consistentes.

Fluxo de trabalho

1. Defina dialecto para postgresql, transactsql, mysql ou sqlite conforme o alvo de migração.
2. Cole SQL de migração bruto de diff gerado ou saída ORM.
3. Beautify com Strip desligado se comentários inline documentam intenção.
4. Copie SQL formatado de volta ao ficheiro de migração antes de abrir o PR.

Dica

A formatação não valida contra o esquema em vivo. Execute migrações numa base de staging após alterações cosméticas.

Engenheiros de analytics copiam frequentemente SQL de consolas Snowflake, BigQuery ou Redshift com capitalização inconsistente e linhas colapsadas.

Snowflake / BigQuery / Redshift

• Selecione snowflake, bigquery ou redshift antes de Beautify para funções de armazém parsearem corretamente.
• Use Strip comments ao exportar de notebook com notas de sessão --.
• Para listas SELECT muito largas, use controlos de dobra (Expand all / Collapse all) após Beautify.

Spark / Trino / Hive

• Escolha spark para notebooks Databricks e pipelines Spark SQL.
• Escolha trino para consultas federadas compatíveis com Presto entre catálogos.
• Escolha hive para scripts HiveQL legados — cobertura segue regras Hive do sql-formatter.

Código de aplicação guarda SQL frequentemente como string modelo. Minify reduz bytes e escapes para uma linha em JavaScript, Python ou Go.

1. Cole a versão legível do SQL no painel de entrada.
2. Ative Strip comments se desenvolvedores deixaram notas de depuração na consulta.
3. Mude para modo Minify.
4. Copie saída de uma linha para o literal de string (atenção ao escape de aspas).

Se precisar de SQL legível no código-fonte mas compacto em runtime, guarde versão embelezada em docs e minifique só o artefacto de build.

Normalize SQL antes da revisão para diffs focarem lógica, não ruído de espaços.

• Embeleze ambos os lados de comparação quando colega cola SQL numa linha num ticket.
• Use palavras-chave em maiúsculas como estilo consistente — o formatador aplica automaticamente em Beautify.
• Encaminhe saída para Text Diff após formatar duas versões se precisar de diff semântico do texto da consulta.

A caixa Strip comments aplica-se a Beautify e Minify. Quando ativa, a ferramenta remove comentários antes da formatação com regras conscientes do dialecto onde implementadas.

Quando Strip está desligado (Minify)

Minify ainda colapsa espaços numa linha mas mantém texto de comentários. Use quando comentários devem ir com a consulta.

Quando o analisador falha, um banner vermelho mostra Parse error com números de linha e coluna. O editor de entrada destaca a linha de erro quando disponível.

Correções comuns

1. Dialecto errado — mude para o motor que realmente usa (ex. plsql para pacotes Oracle, não Standard SQL).
2. String ou parêntese não fechado — equilibre aspas e parênteses perto da linha indicada.
3. Vírgula final ou cláusula incompleta — termine listas SELECT e CTEs antes de formatar.
4. Conteúdo não-SQL colado — remova envoltórios shell ou JSON em volta da consulta.
5. Sintaxe específica do dialecto em modo genérico — tente dialecto do fornecedor ou simplifique extensões não suportadas.

Se consulta válida ainda falhar, o analisador sql-formatter pode não cobrir essa variante. Reporte upstream ou formate subconjunto simplificado manualmente.

SQL Formatter corre 100 % no navegador. A biblioteca sql-formatter é carregada dinamicamente; formatação executa na thread principal em JavaScript.

• Nenhum texto de consulta é enviado para servidores Dev Tools Suite
• Entrada, saída, dialecto e preferência Strip comments podem persistir em localStorage no dispositivo
• Parâmetros de URL (?dialect=, ?mode=) só refletem definições — não contêm corpo SQL
• Limpe espaço de trabalho (Ctrl/Cmd+L) após trabalhar com dados de produção ou PII

• Faça coincidir dialecto com ambiente de execução antes de Beautify — sucesso na formatação ≠ sucesso em runtime
• Beautify para humanos, Minify para máquinas
• Mantenha Strip desligado quando comentários documentam regras de negócio; ligue para exportações e strings incorporadas
• Verifique saída minificada em base de staging com aspas dollar ou literais exóticos
• Use histórico de sessão e upload de ficheiro para scripts grandes em vez de colar em apps de chat que alteram aspas
• Combine com Text Diff ao comparar duas versões formatadas da mesma consulta de relatório