// 免费工具

Snowflake SQL 格式化工具

在浏览器中格式化 Snowflake SQL。半结构化路径、类型转换、QUALIFY 和窗口函数都会排版整齐,含义保持不变。

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

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

格式化的 SQL
SELECT
    o.order_id,
    o.src:customer.name::string AS customer,
    f.value:sku::string AS sku
FROM
    raw_orders o, LATERAL FLATTEN(input => o.src:items) f
WHERE
    o.loaded_at >= DATEADD(day, -1, CURRENT_TIMESTAMP())
QUALIFY
    ROW_NUMBER() OVER (PARTITION BY o.order_id ORDER BY o.loaded_at DESC) = 1

Loading the formatter…

编辑器中的快捷键: Ctrl+输入 格式,以及 Ctrl+Shift+输入 压缩(⌘ 代替 Ctrl 在 Mac 上)。你的设置会记在这个浏览器里,也保留在页面地址中,因此分享链接时带出的是你的样式 – 而不是你的 SQL。

格式化器如何处理 Snowflake SQL

  • 半结构化路径保持完整。 src:customer.name::string 和 f.value:sku 会保持为一个完整的表达式。
  • QUALIFY 会被单独作为一个子句。 QUALIFY 的排布方式和 HAVING,以及 OVER (PARTITION BY … ORDER BY …) 会沿用你的关键字大小写。
  • 类型转换和函数。 :: 类型转换保持紧凑, LATERAL FLATTEN(input => …) 命名参数保持原样。
  • 美元引号括起的内容保持不变,所以 $$ … $$ 存储过程或 UDF 主体会原样输出。

值得了解

  • 诸如 @my_stage/path/ 尚未支持格式化。包含它的 SQL 会原样返回,并附上一条指向 @.
  • 关键字大小写适用于标准 SQL 和 PostgreSQL 关键字,因此某些仅限 Snowflake 的单词会保持你输入的大小写。

示例

Snowflake 格式化前后对比

之前
select o.order_id, o.src:customer.name::string as customer, f.value:sku::string as sku from raw_orders o, lateral flatten(input => o.src:items) f where o.loaded_at >= dateadd(day, -1, current_timestamp()) qualify row_number() over (partition by o.order_id order by o.loaded_at desc) = 1
之后
SELECT
    o.order_id,
    o.src:customer.name::string AS customer,
    f.value:sku::string AS sku
FROM
    raw_orders o, LATERAL FLATTEN(input => o.src:items) f
WHERE
    o.loaded_at >= DATEADD(day, -1, CURRENT_TIMESTAMP())
QUALIFY
    ROW_NUMBER() OVER (PARTITION BY o.order_id ORDER BY o.loaded_at DESC) = 1

输出采用 Standard 样式和 4 空格缩进,与上方格式化器生成的结果完全一致。可将样式切换为 紧凑 用于更紧凑的 SQL,或 已展开 用于前置逗号和每行一项。该 格式化工具文档 涵盖详细信息。

Snowflake 格式化工具常见问题

格式化器如何读取 Snowflake SQL?

按它的 PostgreSQL 规则来解析——与 Snowflake 的引号、:: 转换和 $$ 字符串一致。在此基础上,它会把 col:path 访问保持为一个整体,并把 QUALIFY 作为独立子句来排版。

为什么它没有改动我的 COPY INTO 语句?

尚不支持 @my_stage 这样的 stage 引用,包含它们的 SQL 会按原样返回,并附注说明格式化在哪里停了下来。

我的 SQL 会被发送到服务器吗?

不会。格式化工具编译成了 WebAssembly,在你的浏览器标签页中运行。你的 SQL 绝不会被上传、记录或存储;页面加载后,断网也能继续使用。

格式化会破坏我的查询吗?

它的设计目标就是不破坏。格式化后,SQLly 会逐个令牌地把输出与你的输入比对。如果除空白和你要求的大小写之外还有任何变化,它会把你原本的 SQL 原样返回,并告诉你原因。无法顺利解析的 SQL,例如未终止的字符串,也会原样保留,并附上问题所在的行和列。

我可以与团队共享我的格式化设置吗?

是的。包括高级设置在内的每一项设置都保存在页面地址 # 号之后,因此复制地址或点击“复制设置链接”,对方得到的就是和你完全相同的样式。链接只包含设置,绝不含你的 SQL。

// 格式化只是最次要的部分

喜欢这个格式化工具?来认识一下 SQLly 的其他功能

适用于 macOS、Windows 和 Linux 的原生 SQL 工作台,智能感知能理解你的数据库模式,高危查询有防护,这款格式化工具就内置在编辑器里。