深蓝色网格背景上的 PostgreSQL 大象标志,用于说明 PostgreSQL 19 版本发布

图:PostgreSQL 官方大象标志(postgresql.org)搭配生成的背景。

PostgreSQL 19 于 2026 年 11 月 19 日正式发布,最抢眼的功能是运维团队等了很多年的
能力:可以在不让表下线的前提下回收膨胀表占用的磁盘空间。新的 REPACK 命令正是为此
而生,而 REPACK (CONCURRENTLY) 去掉了让 VACUUM FULL 和 CLUSTER 在繁忙生产库上几乎
无法使用的那把排他锁。

但这次发布远不止一条新语法。PostgreSQL 19 还带来了内核级的查询计划控制、备库上的
“读己之写”一致性、序列值的逻辑复制,以及一批默认值的变更 —— 不看迁移说明就直接升级的
人会被这些默认值咬一口。下面我们逐项拆解:改了什么、在真实 Linux 服务器上意味着什么、
升级前该检查哪些地方。

项目官网:https://www.postgresql.org/

REPACK:不再需要维护窗口的表维护

多年来,处理膨胀表的标准建议一直是 VACUUM FULL 或 CLUSTER。两者都会重写整张表,
而且全程持有 ACCESS EXCLUSIVE 锁。在有流量的表上,这意味着读写要被阻塞整个重写过程;
如果表很大,”整个过程”可能是好几个小时。

PostgreSQL 19 把这两个命令合并成一把更好用的工具。官方文档的描述是”重写表以回收磁盘
空间”,语法如下:

Sql
REPACK [ ( option [, ...] ) ] [ table_and_columns [ USING INDEX [ index_name ] ] ]
REPACK [ ( option [, ...] ) ] USING INDEX

可选参数为 VERBOSE、ANALYZE 和 CONCURRENTLY。为兼容旧版本,VACUUM FULL 与
CLUSTER 仍然保留,但官方现在引导新部署使用 REPACK。

真正关键的是这一条:”重写表时会获取 ACCESS EXCLUSIVE 锁,除非指定了 CONCURRENTLY
选项
。”

Sql
-- 回收单表空间,同时不阻塞读与写
REPACK (CONCURRENTLY, ANALYZE, VERBOSE) public.events;

-- 按索引顺序重排行数据,同样不阻塞
REPACK (CONCURRENTLY) public.events USING INDEX events_created_at_idx;

有两个细节要特别注意:重写表需要该表上的 MAINTAIN 权限,这是相对旧行为(拥有表即可)
的有意改动。

AI 生成的插图:表在不中断服务的情况下被重写,数据流在两个立方体之间持续流动

图:AI 生成的 REPACK 概念插图 —— 表格在实时流量旁被重写。非 PostgreSQL 官方截图。

官方文档里还有两点值得原样复述。第一,REPACK“不适合用来防止事务 ID 或 multixact ID
回卷:它会重写整张表和所有索引,比 VACUUM 慢得多,而且可能在大半工作做完之后才失败,
在繁忙表上配合 CONCURRENTLY 尤其如此” —— 防回卷请继续用 VACUUM。第二,不指定表名的
整库形式(REPACK 不带表名)不能在事务块中执行,也不能与 CONCURRENTLY 组合使用。

进度可以通过新增的 pg_stat_progress_repack 视图观察,该视图同时覆盖 CLUSTER 与
VACUUM FULL。

pg_plan_advice:在数据库内部锁定查询计划

以往想要”计划稳定性”,要么装 pg_hint_plan 这类外部扩展,要么反复改写 SQL 直到优化器
听话。PostgreSQL 19 把 pg_plan_advice 作为 contrib 模块直接收录进来,配套的
pg_stash_advice 可以按查询自动套用已保存的建议。

工作方式挺有意思。加载模块,然后让 EXPLAIN 告诉你它选了哪个计划,以及用什么样的建议
字符串可以复现这个计划:

Sql
LOAD 'pg_plan_advice';

EXPLAIN (COSTS OFF, PLAN_ADVICE)
SELECT * FROM join_fact f JOIN join_dim d ON f.dim_id = d.id;

输出里会附带一段自动生成的建议:

Bash
Generated Plan Advice:
JOIN_ORDER(f d)
HASH_JOIN(d)
SEQ_SCAN(f d)
NO_GATHER(f d)

JOIN_ORDER(f d) 表示 f 应当作为驱动表,HASH_JOIN(d) 表示 d 应放在哈希连接的
内侧,依此类推。你可以只强制执行其中你关心的部分:

Sql
SET pg_plan_advice.advice = 'JOIN_ORDER(f d)';

模块可以通过 shared_preload_libraries 全局加载,通过 session_preload_libraries
按会话加载,或者用 LOAD 命令在单个会话中加载。文档对风险说得很直白:”因为优化器通常
做出的决定是好的,覆盖它的判断很容易适得其反。”如果底层数据分布发生变化,被钉死的计划
可能远差于优化器自己挑出来的那个。

备库上的”读己之写”:WAIT FOR LSN

把读请求分散到备库上的应用,长期卡在一堵一致性墙上:往主库写完立刻去备库读,备库可能
还没回放这笔写入。PostgreSQL 19 用一条 WAIT 命令补上了这个缺口。

Sql
WAIT FOR LSN '0/16B3748'
  WITH (MODE 'standby_replay', TIMEOUT '10s', NO_THROW);

mode 决定备库要推进到哪一步:standby_replay(默认)、standby_write、
standby_flush 或 primary_flush。命令返回 success、timeout 或 not in recovery。
加上 NO_THROW 后,超时会被当作状态字符串返回,而不是抛错误。

实际用法是:在主库上拿到这笔写入的 LSN,在读之前先在备库上等这个 LSN 到位:

Sql
-- 主库上执行
SELECT pg_current_wal_lsn() AS lsn INTO lsn FROM write_result;

-- 备库上,读取之前执行
SELECT pg_advisory_lock(4711);
EXECUTE format('WAIT FOR LSN %L WITH (MODE %L, TIMEOUT %L)', lsn, 'standby_replay', '10s');

逻辑复制:支持序列,不用再重启

过去开启逻辑复制必须重启服务器,把 wal_level 提到 logical。PostgreSQL 19 取消了
这个步骤:创建第一个逻辑复制槽时,系统会自动把有效 WAL 级别提升上去。新的
effective_wal_level 参数可以查看当前实际生效的级别。

序列值的逻辑复制是全新能力。创建发布时用 FOR ALL SEQUENCES 即可发布序列:

Sql
CREATE PUBLICATION my_pub FOR ALL TABLES, FOR ALL SEQUENCES;

另外 CREATE PUBLICATION ... FOR ALL TABLES 新增了 EXCEPT 子句,可以把个别表排除
在外;CREATE SUBSCRIPTION 现在可以通过 SERVER 子句从外部服务器(比如用
postgres_fdw 定义的)读取连接参数。

AI 生成的插图:两个同步的数据库节点通过流式复制通道连接

图:AI 生成的复制与”读己之写”一致性插图。非 PostgreSQL 官方截图。

autovacuum:并行 worker 加打分系统

autovacuum 现在可以用并行 worker 清理索引,由服务器级 autovacuum_max_parallel_workers
和表级 autovacuum_parallel_workers 存储参数控制。实际数量受 max_parallel_workers
上限约束,所以要先把这个值调够。

autovacuum 还引入了优先级打分系统,通过新增的 pg_stat_autovacuum_scores 视图暴露,
可以直观看到守护进程认为哪些表最需要处理。

普通表扫描现在也能把页面标记为 visibility map 中的 all-visible。以前只有 VACUUM 和
COPY ... FREEZE 能做到,一次普通 SELECT 会让可见性图保持原样,导致后续 vacuum
要干更多的活。

性能与 SQL 新特性

外键约束检查变快了 —— 项目自己的测试中,这让批量插入快了接近 2 倍。优化器现在能把
部分 NOT IN 子句转成更高效的 anti-join,并且可以先聚合再连接,减少需要处理的行数。

异步 I/O 方面,io_method = worker 现在会根据负载自动调节后台 worker 数量。旧的
io_workers 变量已移除,换成四个新变量:io_min_workers、io_max_workers、
io_worker_launch_interval 与 io_worker_idle_timeout。

默认的 TOAST 压缩算法从 pglz 换成了更高效的 lz4。窗口函数 lead()、lag()、
first_value()、last_value() 和 nth_value() 现在支持 IGNORE NULLS /
RESPECT NULLS。

对开发者最实用的改进是 INSERT ... ON CONFLICT DO SELECT ... RETURNING,冲突时返回
已存在的行,还可以用 FOR UPDATE / FOR SHARE 锁住它 —— 一次往返就完成
“取或建”:

Sql
INSERT INTO tags (name) VALUES ('postgres')
ON CONFLICT (name) DO SELECT
RETURNING id, old.id IS NULL AS created;

其他新增:COPY TO 可以输出 JSON,配合 FORCE_ARRAY 选项还能输出单个 JSON 数组;
COPY TO 现在能直接处理分区表;COPY FROM 新增 ON_ERROR SET_NULL;SQL/JSON 路径语言
加入了 lower()、upper()、replace()、split_part()、btrim() 等字符串方法。

可观测性也有提升。新增视图包括 pg_stat_lock、pg_stat_recovery、
pg_stat_autovacuum_scores 和 pg_stat_progress_repack。EXPLAIN ANALYZE 新增 IO
选项(配套的 auto_explain 设置)可以报告异步 I/O 活动,而且 log_lock_waits 现在
默认开启。

升级清单

这部分建议读两遍。PostgreSQL 19 改动了若干默认值,迁移说明也明确列出了不兼容项。

JIT 现在默认关闭。 从 PostgreSQL 12 起 JIT 默认开启,但决定何时编译的成本模型被
证明不可靠。如果你跑大型分析型查询,需要手动重新开启并复查执行计划。

standard_conforming_strings 现在恒为开启状态。 用 19 之前的 pg_dump 或
pg_dumpall 且带 standard_conforming_strings = off 导出的转储,无法正确加载进
PostgreSQL 19。请用 PostgreSQL 19 或更新的客户端重新生成,或生成时显式指定
standard_conforming_strings = on。

max_locks_per_transaction 默认值从 64 翻倍到 128。 锁的分配方式变了,原有设置
实际上需要加倍才能维持以前的容量。

RADIUS 认证被移除。 PostgreSQL 只支持过基于 UDP 的 RADIUS,发布说明称其”存在无法
修复的安全问题”。

MD5 密码现在会在登录成功后给出警告。 可以用 md5_password_warnings 关掉,但正确
做法是迁移到 SCRAM。

新增密码过期警告。 新参数 password_expiration_warning_threshold 默认为 7 天。

inet 与 cidr 类型的默认索引 opclass 从 btree_gist 改为 GiST,因为旧的实现会
漏掉本该返回的行。仍在使用 btree_gist 的 inet/cidr 索引的集群,pg_upgrade
会拒绝升级。

io_workers 已被移除,换成上面那四个 io_worker_* 变量。

另外注意:数据库名、角色名和表空间名现在不允许包含回车与换行符,pg_upgrade 会拒绝
升级含有此类名称的集群。

升级方式为 pg_upgrade、pg_dumpall 转储恢复,或逻辑复制 —— 从任何旧大版本迁移都
必须走这三者之一。在 Debian 与 Ubuntu 上,PostgreSQL APT 仓库已经上架了该版本
(postgresql-19,19.0),同时提供 postgresql-client-19:

Bash
sudo apt install postgresql-19 postgresql-client-19

如果自建仓库,请为你的发行版添加 PGDG apt 源后从那里安装 —— 新的大版本总是先落在那里。

结论

PostgreSQL 19 是一次”面向规模化可靠性”的发布。REPACK (CONCURRENTLY) 是最可能改变
日常运维的 feature:它把一次计划内停机变成一个后台任务。pg_plan_advice 把计划控制
搬进了内核,WAIT FOR LSN 修掉了应用团队用各种变通办法绕了很多年的一致性问题,并行
autovacuum 也终于跟得上现代存储了。

真正的坑在默认值上。一个同时改掉 standard_conforming_strings、让你的有效锁容量减半、
关掉 JIT 并移除 RADIUS 的版本,不是 apt upgrade 就能了事的 —— 请读迁移说明、演练一遍
恢复流程,在验证通过之前把旧集群留着。

最后修改: 2026年11月21日

作者

评论

发表评论

您的邮箱地址不会被公开。