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.
Cada configuração de layout do formatador, agrupada como Editor › Formatação no app SQLly. O estilo acima é o ponto de partida; qualquer alteração feita aqui fica marcada.
Arraste um arquivo .sql aqui para abri-lo. Ele é lido no seu navegador, não enviado.
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, enquantox>=-1ainda é lido comox >= -1. - Casts e arrays ficam onde estão.
created_at::datepermanece junto, eARRAY['a','b'],tags[1],tags[2:3]etext[]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 ouDObloco, sai exatamente como entrou. - Parâmetros e literais sobrevivem.
$1placeholders, psql:variables,E'…'faz o escape de strings,B'…'eX'…'strings de bits eU&'…'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'eNULLS 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
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;
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.
Outros dialetos
- Qualquer dialeto (detecção automática)
- Formatador SQL Server (T-SQL)
- Formatador MySQL
- Formatador SQLite
- Formatador Oracle SQL
- Formatador SQL do Snowflake
- Formatador de SQL do BigQuery
- Formatador SQL do Redshift
Trabalhando com PostgreSQL todos os dias? Veja o que o aplicativo desktop do SQLly faz pelo PostgreSQL, ou explore todos os recursos.
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.