PostgreSQL 格式化工具
在浏览器中格式化 PostgreSQL。类型转换、美元引号函数体、JSONB 操作符和数组都按 Postgres 的方式解读,因此格式化工具只改动空白和你要的大小写。
格式化程序的每个布局设置,分组方式类似 编辑器 › 格式化 在 SQLly 应用中。上面的样式是起点;你在这里做的任何更改都会被标记。
把 .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。
其他方言
- 任何方言(自动检测)
- SQL Server 格式化工具 (T-SQL)
- MySQL 格式化工具
- SQLite 格式化工具
- Oracle SQL 格式化工具
- Snowflake SQL 格式化工具
- BigQuery SQL 格式化工具
- Redshift SQL 格式化工具
每天都在用 PostgreSQL?看看 SQLly 桌面应用为 PostgreSQL 所做的,或浏览所有 功能.
喜欢这个格式化工具?来认识一下 SQLly 的其他功能
适用于 macOS、Windows 和 Linux 的原生 SQL 工作台,智能感知能理解你的数据库模式,高危查询有防护,这款格式化工具就内置在编辑器里。