select a,b from t where x=1 and y=2 entra, e saem oito linhas curtas e indentadas. É tudo o que um formatador de SQL faz, e poupa muito esforço para ler uma consulta de 400 caracteres que alguém colou num chamado. Este cobre 20 dialetos, do SQL padrão ao PostgreSQL, MySQL, BigQuery e T-SQL.
Cole, escolha um dialeto, leia o resultado
- Cole a consulta em Entrada SQL. O exemplo traz um join com uma subconsulta, um
INSERTe umUPDATE. - Escolha o Dialeto. O padrão é SQL padrão.
- Defina a Caixa das palavras-chave, a Indentação e as outras opções. Cada mudança formata de novo na hora.
- Espere cerca de 300 ms depois de digitar, ou aperte Formatar.
- Aperte Copiar, ou Baixar .sql para salvar um arquivo chamado
formatted.sql.
Por que uma consulta falha no dialeto errado
O SQL padrão não conhece o cast do PostgreSQL a::int e não lê o nome do T-SQL [dbo].[orders]. O formatador então para com um erro de análise e a posição do token ruim. Troque para PostgreSQL ou SQL Server e o mesmo texto é formatado normalmente.
A caixa de erro mostra a mensagem da biblioteca e uma dica para mudar o dialeto.
Marcadores: ?, $1, :nome, @nome
Instruções preparadas contêm marcadores. O SQL padrão rejeita :nome, @nome e $1 até que você escolha um estilo. Se o erro apontar para um deles, abra Estilo de marcador e escolha o estilo que o seu driver usa. Todos os estilos aceita os quatro ao mesmo tempo. Os marcadores permanecem no texto. Nada é substituído por um valor.
Opções de layout para palavras-chave, operadores e AND / OR
As palavras-chave ficam em maiúsculas, em minúsculas ou como digitadas. A indentação é de 2 espaços, 4 espaços ou uma tabulação. A Largura da expressão (50, 80 ou 120 caracteres) decide quanto uma expressão entre parênteses pode ficar numa linha. Você pode pôr 1 ou 2 linhas em branco entre consultas, tirar os espaços em volta dos operadores (a=b) e colocar AND e OR no início ou no fim de uma linha.
O que o formatador não faz
Ele muda espaços em branco e a caixa das palavras-chave. Não executa o SQL, não conhece as suas tabelas e não diz se a consulta está correta. Os comentários ficam onde estão, e o texto dentro de literais de string nunca é tocado. Para manter um bloco como está, envolva-o com /* sql-formatter-disable */ e /* sql-formatter-enable */. A biblioteca não aceita procedimentos armazenados nem um delimitador diferente de ;.
Entradas acima de 2.000.000 de caracteres são recusadas com uma mensagem.
Para onde vai o seu SQL
Para lugar nenhum. A biblioteca de formatação faz parte do código da página e roda no seu navegador. Formatar não envia nenhuma requisição, o que você pode confirmar no painel de rede do navegador. Copiar usa a área de transferência, e Baixar .sql grava um arquivo no seu próprio dispositivo.