Formatador de SQL do BigQuery
Formate GoogleSQL para BigQuery no seu navegador. Caminhos de tabela com crase, parâmetros de consulta, arrays e QUALIFY ficam intactos e são organizados de forma limpa.
O formatador lê SQL do BigQuery com suas regras do MySQL, além da sintaxe do BigQuery listada abaixo.
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
user_id,
COUNT(*) AS sessions,
ARRAY_AGG(page ORDER BY ts LIMIT 5) AS first_pages
FROM
`my-project.analytics.events`
WHERE
event_name = @event
AND 'beta' IN UNNEST(tags)
AND ts >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 day)
GROUP BY
user_id
QUALIFY
ROW_NUMBER() OVER (ORDER BY COUNT(*) DESC) <= 100
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 BigQuery
- Caminhos de tabela entre crases.
`my-project.analytics.events`é um nome entre aspas, com hífens inclusive. - Parâmetros de consulta.
@eventparâmetros nomeados são lidos como tokens únicos. - Os arrays ficam como foram escritos.
[1, 2, 3]literais earr[OFFSET(0)]subscritos são mantidos exatamente como você digitou, eUNNEST,STRUCTeARRAY_AGGchamadas são dispostas como qualquer função. - QUALIFY recebe sua própria cláusula, organizada como
HAVING, eINTERVALeOVER (PARTITION BY …)recebem as maiúsculas e minúsculas das suas palavras-chave. - Comentários e strings.
#comentários são mantidos, texto entre aspas duplas é uma string, er'…'literais raw eb'…'os literais de bytes ficam ligados ao seu prefixo.
Bom saber
- A capitalização de palavras-chave cobre as palavras-chave do SQL padrão e do MySQL, então algumas palavras exclusivas do BigQuery mantêm a capitalização que você digitou.
Exemplos
BigQuery antes e depois
select user_id, count(*) as sessions, array_agg(page order by ts limit 5) as first_pages from `my-project.analytics.events` where event_name = @event and 'beta' in unnest(tags) and ts >= timestamp_sub(current_timestamp(), interval 7 day) group by user_id qualify row_number() over (order by count(*) desc) <= 100
SELECT
user_id,
COUNT(*) AS sessions,
ARRAY_AGG(page ORDER BY ts LIMIT 5) AS first_pages
FROM
`my-project.analytics.events`
WHERE
event_name = @event
AND 'beta' IN UNNEST(tags)
AND ts >= TIMESTAMP_SUB(CURRENT_TIMESTAMP(), INTERVAL 7 day)
GROUP BY
user_id
QUALIFY
ROW_NUMBER() OVER (ORDER BY COUNT(*) DESC) <= 100
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 do BigQuery
Como o formatador lê o SQL do BigQuery?
Com suas regras do MySQL, que compartilham o uso de aspas com backtick do BigQuery, comentários # e strings entre aspas duplas. Além disso, ele entende @parâmetros, arrays [ ] e QUALIFY.
Ele vai quebrar meus nomes entre backticks como project.dataset.table?
Não. Um caminho entre crases é um único nome para o formatador, então ele é mantido exatamente como escrito.
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.
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.