// ferramenta gratuita

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.

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

SQL formatado
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. @event parâmetros nomeados são lidos como tokens únicos.
  • Os arrays ficam como foram escritos. [1, 2, 3] literais e arr[OFFSET(0)] subscritos são mantidos exatamente como você digitou, e UNNEST, STRUCT e ARRAY_AGG chamadas são dispostas como qualquer função.
  • QUALIFY recebe sua própria cláusula, organizada como HAVING, e INTERVAL e OVER (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, e r'…' literais raw e b'…' 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

Antes
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
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

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.

// 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.