// 免费工具

PostgreSQL 格式化工具

在浏览器中格式化 PostgreSQL。类型转换、美元引号函数体、JSONB 操作符和数组都按 Postgres 的方式解读,因此格式化工具只改动空白和你要的大小写。

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

格式化的 SQL
SELECT
    id,
    payload ->> 'kind' AS kind,
    payload #>> '{user,id}' AS user_id,
    tags[1] AS first_tag
FROM
    events
WHERE
    tags @> ARRAY['beta']::TEXT[]
    AND payload ? 'source'
    AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
    created_at DESC NULLS LAST
LIMIT 50;

Loading the formatter…

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

格式化器如何处理 PostgreSQL SQL

  • 运算符的读取方式与 Postgres 相同。 PostgreSQL 会把连续的操作符字符当作一个操作符,格式化工具也是如此: ->>, #>>, @>, <@, ?|, || 并且你自己的自定义运算符也绝不会被拆散,而 x>=-1 读起来仍然是 x >= -1.
  • 类型转换和数组保持原样。 created_at::date 保持紧密,并且 ARRAY['a','b'], tags[1], tags[2:3] 和 text[] 会完全按原样保留。
  • 美元引号括起的主体不受影响。 一个 $$ … $$ 或者 $tag$ … $tag$ 字符串的主体,例如函数或 DO 块,输出时与输入完全一致。
  • 参数和字面量保持不变。 $1 占位符、psql :variables, E'…' 转义字符串、 B'…' 和 X'…' 位串和 U&'…' Unicode 字符串都是单独的标记。
  • 大小写安全引用。 PostgreSQL 会把未加引号的名称转为小写,因此 移除不必要的引号 只对本身已是小写的名称去引号。 "Users" 保留其引号。
  • Postgres 关键字会遵循你设置的大小写,包括 RETURNING, ILIKE, LATERAL, INTERVAL '7 days' 和 NULLS LAST.

值得了解

  • 对格式化器来说,函数体内的 SQL 只是一个字符串,因此会按原样保留,而不会重新格式化。

示例

PostgreSQL 格式化前后

之前
select id, payload->>'kind' as kind, payload#>>'{user,id}' as user_id, tags[1] as first_tag from events where tags @> array['beta']::text[] and payload ? 'source' and created_at > now() - interval '7 days' order by created_at desc nulls last limit 50;
之后
SELECT
    id,
    payload ->> 'kind' AS kind,
    payload #>> '{user,id}' AS user_id,
    tags[1] AS first_tag
FROM
    events
WHERE
    tags @> ARRAY['beta']::TEXT[]
    AND payload ? 'source'
    AND created_at > NOW() - INTERVAL '7 days'
ORDER BY
    created_at DESC NULLS LAST
LIMIT 50;

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

PostgreSQL 格式化工具常见问题

PostgreSQL 格式化工具会破坏 ->> 或 @> 这类 JSONB 操作符吗?

不。它像 PostgreSQL 一样读取运算符,把连续的运算符字符视为一个整体,因此 ->>、#>>、@>、<@、?| 和自定义运算符绝不会被拆开。如果它的输出无法解析回相同的 SQL,就会原样返回你的输入。

它会重新格式化 $$ 引号之间的函数体吗?

不会。美元符引用的函数体是字符串字面量,格式化器从不改动字符串内部;其外围的 CREATE FUNCTION 语句仍会正常排版。

它会去掉 "MixedCase" 名称的引号吗?

只在你要求时才处理,且只在安全时执行。PostgreSQL 会把未加引号的名称转为小写,所以“只去掉不必要的引号”只对本来就是小写且不是关键字的名称去引号。

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

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

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

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

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

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

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

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

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