// ferramenta gratuita

Formatador PostgreSQL

Formate PostgreSQL no seu navegador. Casts, corpos entre aspas de cifrão, operadores JSONB e arrays são lidos do jeito que o Postgres lê, então o formatador só altera espaços em branco e as maiúsculas e minúsculas que você pedir.

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

SQL formatado
SELECT
    id,
    payload ->> 'kind' AS kind,
    payload #>> '{user,id}' AS user_id,
    tags[1] AS first_tag
FROM
    events
WHERE
    tags @> ARRAY['beta']::TEXT[]
    AND payload ? 'source'
    AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
    created_at DESC NULLS LAST
LIMIT 50;

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 PostgreSQL

  • Os operadores são lidos na ordem em que o Postgres os lê. PostgreSQL trata uma sequência de caracteres de operador como um único operador, e o formatador também: ->>, #>>, @>, <@, ?|, || e seus próprios operadores personalizados nunca são separados, enquanto x>=-1 ainda é lido como x >= -1.
  • Casts e arrays ficam onde estão. created_at::date permanece junto, e ARRAY['a','b'], tags[1], tags[2:3] e text[] são mantidos exatamente como escritos.
  • Corpos entre aspas com cifrão não são alterados. O corpo de uma $$ … $$ ou $tag$ … $tag$ string, como uma função ou DO bloco, sai exatamente como entrou.
  • Parâmetros e literais sobrevivem. $1 placeholders, psql :variables, E'…' faz o escape de strings, B'…' e X'…' strings de bits e U&'…' Cada string Unicode é um token.
  • Aspas que preservam maiúsculas e minúsculas. O PostgreSQL converte para minúsculas nomes sem aspas, então Remover aspas desnecessárias apenas remove as aspas de nomes que já estão em minúsculas. "Users" mantém suas aspas.
  • As palavras-chave do Postgres seguem a sua capitalização, incluindo RETURNING, ILIKE, LATERAL, INTERVAL '7 days' e NULLS LAST.

Bom saber

  • Para o formatador, o SQL dentro do corpo de uma função é uma string, então ele é mantido como foi escrito, sem reformatar.

Exemplos

PostgreSQL antes e depois

Antes
select id, payload->>'kind' as kind, payload#>>'{user,id}' as user_id, tags[1] as first_tag from events where tags @> array['beta']::text[] and payload ? 'source' and created_at > now() - interval '7 days' order by created_at desc nulls last limit 50;
Depois
SELECT
    id,
    payload ->> 'kind' AS kind,
    payload #>> '{user,id}' AS user_id,
    tags[1] AS first_tag
FROM
    events
WHERE
    tags @> ARRAY['beta']::TEXT[]
    AND payload ? 'source'
    AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
    created_at DESC NULLS LAST
LIMIT 50;

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 PostgreSQL

O formatador PostgreSQL quebra operadores JSONB como ->> ou @>?

Não. Ele lê operadores da mesma forma que o PostgreSQL, como uma sequência contínua de caracteres de operador, então ->>, #>>, @>, <@, ?| e operadores personalizados nunca são divididos. Se a saída dele não puder ser analisada de volta como o mesmo SQL, ele devolve sua entrada sem alterações.

Ele reformata o corpo de uma função entre aspas $$?

Não. Um corpo entre cifrões é um literal de string, e o formatador nunca altera o interior de uma string. A instrução CREATE FUNCTION ao redor dele continua sendo formatada.

Ele removerá as aspas dos nomes em "MixedCase"?

Apenas se você pedir, e somente quando for seguro. O PostgreSQL converte nomes sem aspas para minúsculas, então Remover aspas desnecessárias remove as aspas apenas de nomes que já estão em minúsculas e não são palavras-chave.

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.