Pontos-chave
- 01Suporta PostgreSQL, MySQL, SQLite, BigQuery e SQL padrão com tratamento de palavras-chave sensível ao dialeto.
- 02Escolha o caso das palavras-chave (MAIÚSCULAS, minúsculas ou preservar) e indentação (2 espaços, 4 espaços ou tabulações).
- 03Funciona inteiramente no seu navegador — consultas com dados sensíveis nunca saem do seu dispositivo.
- 04A ferramenta apenas reformata o texto; ela não executa consultas nem se conecta a nenhum banco de dados.
Por Que Formatar SQL Antes de Compartilhá-lo?
SQL não formatado é genuinamente difícil de revisar. Listas SELECT longas comprimidas em uma linha, indentação inconsistente em subconsultas e palavras-chave em casos mistos desaceleram revisões de código e depuração. Uma consulta adequadamente formatada torna as condições JOIN, cláusulas WHERE e estrutura CTE imediatamente legíveis.
A formatação se torna ainda mais importante ao compartilhar consultas em uma equipe com um guia de estilo — palavras-chave em MAIÚSCULAS, indentação de quatro espaços, uma cláusula por linha. O formatador SQL do Handytool aplica esse estilo consistentemente em tudo o que você cola, seja uma consulta de duas linhas ou uma consulta analítica de 200 linhas com múltiplas CTEs e funções de janela.
Como Formatar uma Consulta SQL
- 01
Cole seu SQL
Cole qualquer instrução SQL no painel de entrada — SELECT, INSERT, UPDATE, DELETE, CREATE ou uma cadeia CTE completa. Não há limite de tamanho além da memória disponível do seu navegador.
- 02
Selecione o dialeto
Escolha PostgreSQL, MySQL, SQLite, BigQuery ou SQL Padrão no menu suspenso. O dialeto determina como palavras reservadas e sintaxe específica do fornecedor, como RETURNING ou STRUCT, são tratadas.
- 03
Defina o caso das palavras-chave e indentação
Escolha MAIÚSCULAS, minúsculas ou Preservar para o caso das palavras-chave. Escolha 2 espaços, 4 espaços ou tabulações para indentação. Palavras-chave em MAIÚSCULAS com indentação de 2 espaços é o estilo mais comum em bases de código compartilhadas.
- 04
Clique em Formatar
A saída formatada aparece no painel direito instantaneamente. As cláusulas são colocadas em suas próprias linhas, as condições JOIN são alinhadas e as subconsultas são indentadas em relação ao seu pai.
- 05
Copie e use
Clique em Copiar para copiar o SQL formatado para sua área de transferência. Cole em seu IDE, um arquivo SQL, uma descrição de PR ou um trecho de documentação.
Seguro para Usar com Padrões de Consulta de Produção
A biblioteca sql-formatter funciona inteiramente no seu navegador. Nada é enviado para um servidor — nenhum texto de consulta, nenhum nome de tabela, nenhum dado de amostra. Isso torna seguro formatar consultas que fazem referência a nomes de esquema reais ou contêm valores de amostra de um banco de dados de preparação.
Uma coisa que o formatador não fará é executar seu SQL. É apenas uma ferramenta de transformação de texto. Você pode colar com segurança consultas que descartariam tabelas ou excluiriam linhas — a ferramenta as trata como texto simples e as reformata sem executar uma única instrução.
Perguntas Frequentes sobre Formatador SQL
Quais dialetos SQL este formatador suporta?
SQL Padrão, PostgreSQL, MySQL, SQLite e BigQuery. Cada dialeto trata corretamente a sintaxe específica do fornecedor, como a cláusula RETURNING do PostgreSQL, identificadores entre crases do MySQL e o tipo STRUCT do BigQuery.
O formatador executará minha consulta?
Não. Ele apenas reformata o texto da consulta. Ele não se conecta a nenhum banco de dados, valida nomes de coluna ou executa instruções.
Meu SQL é enviado para algum servidor?
Não. A biblioteca sql-formatter funciona no seu navegador. O texto da sua consulta permanece no seu dispositivo.
Por que meu procedimento armazenado ou bloco PL/pgSQL formata de forma estranha?
Blocos SQL procedurais (PL/pgSQL, blocos BEGIN…END, seções DECLARE) estão fora do que a gramática do formatador cobre. Formate separadamente trechos SELECT ou DML menores dentro desses blocos.
Qual é o melhor caso de palavra-chave para uma base de código compartilhada?
Palavras-chave em MAIÚSCULAS são a convenção mais amplamente adotada — elas separam visualmente a estrutura SQL dos nomes de identificadores. Indentação de dois espaços ou quatro espaços é uma questão de preferência da equipe.