BigQuery SQL 格式化工具
在浏览器中格式化 BigQuery 的 GoogleSQL。保持反引号表路径、查询参数、数组和 QUALIFY 不变,并整齐排列。
格式化器按其 MySQL 规则解析 BigQuery SQL,并支持下面列出的 BigQuery 语法。
格式化程序的每个布局设置,分组方式类似 编辑器 › 格式化 在 SQLly 应用中。上面的样式是起点;你在这里做的任何更改都会被标记。
把 .sql 文件拖到此处即可打开。文件只在你的浏览器中读取,不会上传。
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…
编辑器中的快捷键: Ctrl+输入 格式,以及 Ctrl+Shift+输入 压缩(⌘ 代替 Ctrl 在 Mac 上)。你的设置会记在这个浏览器里,也保留在页面地址中,因此分享链接时带出的是你的样式 – 而不是你的 SQL。
格式化器如何处理 BigQuery SQL
- 用反引号括住表路径。
`my-project.analytics.events`是一个带引号的名称,连字符也一并保留。 - 查询参数。
@event命名参数会被当作单个标记来读取。 - 数组保持原样。
[1, 2, 3]字面量和arr[OFFSET(0)]下标会完全按你输入的样子保留,而且UNNEST,STRUCT和ARRAY_AGG调用会像普通函数一样排版。 - QUALIFY 有自己独立的子句,排布像
HAVING,以及INTERVAL和OVER (PARTITION BY …)会沿用你的关键字大小写。 - 注释和字符串。
#注释会被保留,双引号文本是字符串,且r'…'raw 和b'…'字节字面量始终与前缀保持相连。
值得了解
- 关键字大小写涵盖标准 SQL 和 MySQL 关键字,所以一些仅在 BigQuery 中使用的词会保持你输入的大小写。
示例
BigQuery 格式化前后对比
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
输出采用 Standard 样式和 4 空格缩进,与上方格式化器生成的结果完全一致。可将样式切换为 紧凑 用于更紧凑的 SQL,或 已展开 用于前置逗号和每行一项。该 格式化工具文档 涵盖详细信息。
BigQuery 格式化工具常见问题
格式化器如何读取 BigQuery SQL?
按它的 MySQL 规则来解析——这些规则与 BigQuery 的反引号引用、# 注释和双引号字符串一致。在此基础上,它还认识 @parameters、[ ] 数组和 QUALIFY。
它会破坏我的反引号 project.dataset.table 名称吗?
不。对格式化器而言,反引号括起来的路径是一个完整名称,因此会原样保留。
我的 SQL 会被发送到服务器吗?
不会。格式化工具编译成了 WebAssembly,在你的浏览器标签页中运行。你的 SQL 绝不会被上传、记录或存储;页面加载后,断网也能继续使用。
格式化会破坏我的查询吗?
它的设计目标就是不破坏。格式化后,SQLly 会逐个令牌地把输出与你的输入比对。如果除空白和你要求的大小写之外还有任何变化,它会把你原本的 SQL 原样返回,并告诉你原因。无法顺利解析的 SQL,例如未终止的字符串,也会原样保留,并附上问题所在的行和列。
我可以与团队共享我的格式化设置吗?
是的。包括高级设置在内的每一项设置都保存在页面地址 # 号之后,因此复制地址或点击“复制设置链接”,对方得到的就是和你完全相同的样式。链接只包含设置,绝不含你的 SQL。
喜欢这个格式化工具?来认识一下 SQLly 的其他功能
适用于 macOS、Windows 和 Linux 的原生 SQL 工作台,智能感知能理解你的数据库模式,高危查询有防护,这款格式化工具就内置在编辑器里。