// 免费工具

BigQuery SQL 格式化工具

在浏览器中格式化 BigQuery 的 GoogleSQL。保持反引号表路径、查询参数、数组和 QUALIFY 不变,并整齐排列。

格式化器按其 MySQL 规则解析 BigQuery SQL,并支持下面列出的 BigQuery 语法。

把 .sql 文件拖到此处即可打开。文件只在你的浏览器中读取,不会上传。

格式化的 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 工作台,智能感知能理解你的数据库模式,高危查询有防护,这款格式化工具就内置在编辑器里。