// ferramenta gratuita

Formatador MySQL

Formate consultas MySQL e MariaDB no seu navegador. Aspas invertidas, comentários #, @variáveis e operadores JSON são interpretados à maneira do MySQL, e nada do que você colar é enviado.

Arraste um arquivo .sql aqui para abri-lo. Ele é lido no seu navegador, não enviado.

SQL formatado
# monthly revenue by channel
SELECT
    DATE_FORMAT(o.`created_at`, '%Y-%m') AS `month`,
    o.meta ->> '$.channel' AS channel,
    SUM(oi.`qty` * oi.`price`) AS revenue
FROM
    `orders` o
    JOIN `order_items` oi ON oi.`order_id` = o.`id`
WHERE
    o.`status` = "paid"
    AND o.`customer_id` <=> @customer
GROUP BY
    `month`,
    channel
ORDER BY
    `month` DESC
LIMIT 12;

Loading the formatter…

Atalhos no editor: Ctrl+Enter formata e Ctrl+Shift+Enter minifica (⌘ em vez de Ctrl no Mac). Suas configurações são lembradas neste navegador e mantidas no endereço da página, então um link compartilha seu estilo – nunca seu SQL.

O que o formatador faz com o SQL do MySQL

  • Crases e strings. `order` é um nome entre aspas e "paid" é uma string, como no modo SQL padrão do MySQL. Sempre entre aspas adiciona crases.
  • Todo estilo de comentário é mantido. # comentários, -- comentários e /*! … */ os comentários executáveis ficam onde você os escreveu. O MySQL exige um espaço após --, e o formatador segue a mesma regra.
  • Variáveis são nomes. @rank variáveis de usuário, @@sql_mode variáveis do sistema e := atribuições são lidas como tokens únicos.
  • Operadores JSON e null-safe permanecem intactos. ->, ->> e <=> nunca são divididos em - >> ou <= >, que deixaria de executar.
  • Os literais mantêm seu prefixo. b'0101', x'ff', N'…' e introduzidores de conjunto de caracteres como _utf8mb4'…' permanecem anexados, portanto, nunca são lidos como uma coluna com um alias.
  • Aspas que preservam maiúsculas e minúsculas. Os nomes de tabelas podem ser sensíveis a maiúsculas e minúsculas no Linux, então Remover aspas desnecessárias apenas remove as aspas de nomes em minúsculas.

Bom saber

  • Por padrão, o MySQL rejeita um espaço entre funções internas como COUNT ou SUM e seus parênteses. O formatador escreve COUNT(*) e o Minify mantém as chamadas como você escreveu; só ative Espaço antes dos parênteses da função se o seu servidor executar com IGNORE_SPACE.

Exemplos

MySQL antes e depois

Antes
# monthly revenue by channel
select date_format(o.`created_at`,'%Y-%m') as `month`,o.meta->>'$.channel' as channel,sum(oi.`qty`*oi.`price`) as revenue from `orders` o join `order_items` oi on oi.`order_id`=o.`id` where o.`status`="paid" and o.`customer_id`<=>@customer group by `month`,channel order by `month` desc limit 12;
Depois
# monthly revenue by channel
SELECT
    DATE_FORMAT(o.`created_at`, '%Y-%m') AS `month`,
    o.meta ->> '$.channel' AS channel,
    SUM(oi.`qty` * oi.`price`) AS revenue
FROM
    `orders` o
    JOIN `order_items` oi ON oi.`order_id` = o.`id`
WHERE
    o.`status` = "paid"
    AND o.`customer_id` <=> @customer
GROUP BY
    `month`,
    channel
ORDER BY
    `month` DESC
LIMIT 12;

A saída usa o estilo Standard com indentação de 4 espaços, exatamente como o formatador acima produz. Alterne o estilo para Compacto para SQL mais compacto ou Expandido para vírgulas à frente e um item por linha. A documentação do formatador cobre os detalhes.

FAQ do formatador MySQL

Funciona com o MariaDB?

Sim. O MariaDB usa a mesma sintaxe de aspas, comentários e variáveis, e os comentários executáveis /*M! … */ são mantidos como os /*! … */ do MySQL.

O Minify vai remover meus comentários executáveis /*! … */?

Não. O Minify remove comentários comuns, mas mantém comentários executáveis e dicas de otimizador, porque o servidor executa o que está dentro deles.

Por que o formatador escreve COUNT(*) sem espaço?

Porque o MySQL, a menos que o modo SQL IGNORE_SPACE esteja ativado, não aceita espaço em branco entre COUNT, SUM e algumas outras funções internas e o parêntese de abertura.

Meu SQL é enviado para um servidor?

Não. O formatador é compilado em WebAssembly e roda dentro da aba do seu navegador. Seu SQL nunca é enviado, registrado ou armazenado, e depois que a página carrega, ele continua funcionando offline.

A formatação pode quebrar minha consulta?

Ela foi feita para não fazer isso. Depois de formatar, o SQLly confere a saída token por token com o que você enviou. Se algo além de espaços em branco e da capitalização que você pediu teria de mudar, ele devolve seu SQL exatamente como você escreveu e explica o motivo. SQL que não analisa de forma limpa, como uma string não fechada, também fica intocado, com a linha e a coluna do problema.

Posso compartilhar minhas configurações de formatação com minha equipe?

Sim. Todas as configurações, incluindo as avançadas, são mantidas no endereço da página após o sinal #, então copiar o endereço ou pressionar Copiar link de configurações compartilha seu estilo exato. O link contém apenas as configurações, nunca seu SQL.

// a formatação é o menor problema

Gostou do formatador? Conheça o resto do SQLly

Um workbench SQL nativo para macOS, Windows e Linux, com IntelliSense que conhece o seu esquema, proteções para consultas arriscadas e este formatador integrado ao editor.