Snowflake SQL 格式化工具
在浏览器中格式化 Snowflake SQL。半结构化路径、类型转换、QUALIFY 和窗口函数都会排版整齐,含义保持不变。
格式化器按其 PostgreSQL 规则解析 Snowflake SQL,并支持下面列出的 Snowflake 语法。
格式化程序的每个布局设置,分组方式类似 编辑器 › 格式化 在 SQLly 应用中。上面的样式是起点;你在这里做的任何更改都会被标记。
把 .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 工作台,智能感知能理解你的数据库模式,高危查询有防护,这款格式化工具就内置在编辑器里。