CONFIGURATION PARAMETER清理 / 冻结

vacuum_freeze_min_age

指定 VACUUM 在决定是否冻结带有较旧 XID 的页面时应采用的截止年龄（以事务数计）。

Minimum age at which VACUUM should freeze a table row.

整数会话引入 8.2 现存至 20 devel 0 次默认值变更

类型: 整数integer
上下文: 会话任何用户都可在会话内用 SET 修改
默认值: 50000000
取值范围: 0 – 1000000000
分类: 清理 / 冻结
引入版本: 8.2
状态: 现存

PostgreSQL 18.7 手册官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

50000000 9.0 – 9.4 50000000 9.5 – 19

默认值一共换过 2 档，每段的宽度按它覆盖的大版本数伸展，深色的一段是当前查看的 PostgreSQL 18.7。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18.7 手册 · 19.10 清理本站手册官方原文

指定 VACUUM 在决定是否冻结带有较旧 XID 的页面时应采用的截止年龄（以事务数计）。默认值为 5000 万个事务。尽管用户可以将该值设置在 0 到 10 亿之间，VACUUM 仍会悄悄将其有效值限制为不超过 autovacuum_freeze_max_age 的一半，以避免强制自动清理之间的间隔过短。详见第 24.1.5 节。

机制详解

设置 VACUUM 冻结元组 xmin 时采用的最小 XID 年龄。它是 user context，手工 VACUUM 可在会话中覆盖。

VACUUM 根据该年龄计算 XID 冻结截止点。较小值更早冻结 XID，可能在即将更新的行上重复工作；较大值推迟工作。有效值最高为 autovacuum_freeze_max_age 的一半。

监控各表 age(relfrozenxid) 与所有数据库的 age(datfrozenxid)。应与 vacuum_freeze_table_age、autovacuum_freeze_max_age、vacuum_failsafe_age 联合解释；MXID 由独立的 vacuum_multixact_freeze_min_age 控制。

调优建议

按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。

OLTP在线事务处理

在 autovacuum_freeze_max_age 之前保留足够余量，使日常 VACUUM 能推进 relfrozenxid。依据 XID 峰值消耗与实测清理完成时间调优，不按日历天数猜测。
OLAP分析与批处理

对以追加为主或静态分区，可在计划 VACUUM 中降低该值以更早冻结 XID、减少后续 aggressive 工作；需验证额外 WAL 与扫描成本。
小规格低配实例与开发机

没有 XID 年龄证据就保持上游默认。小数据库同样共享集群事务计数器，仍需监控每个数据库。

常见问题

把该截止点描述成 MXID 控制；MultiXact 使用 vacuum_multixact_freeze_min_age。
不按实测事务速率就把 XID 年龄换算成时间。
把数值提高到日常 VACUUM 在防回卷工作前失去有效余量。
忽略表级 autovacuum_freeze_min_age 覆盖。

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。

PostgreSQL 8.2 ← 8.1 新增此参数

PostgreSQL 8.2 起可用

逐版本快照

每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
8.2	—	—	—	`整数`	—	—	—
8.3	—	—	—	`整数`	—	—	—
8.4	—	—	—	`整数`	—	—	—
9.0	`50000000`	`空`	`会话`	`整数`	`0`	`1000000000`	`—`
9.1	`50000000`	`空`	`会话`	`整数`	`0`	`1000000000`	`—`
9.2	`50000000`	`空`	`会话`	`整数`	`0`	`1000000000`	`—`
9.3	`50000000`	`空`	`会话`	`整数`	`0`	`1000000000`	`—`
9.4	`50000000`	`空`	`会话`	`整数`	`0`	`1000000000`	`—`
9.5	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
9.6	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
10	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
11	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
12	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
13	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
14	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
15	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
16	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
17	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
18	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
19	`50000000`	`—`	`会话`	`整数`	`0`	`1000000000`	`—`
20	—	—	—	`整数`	—	—	—

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Vacuuming 清理 7 个 ↗
冻结 7
`vacuum_failsafe_age`	整数	会话	`1600000000`	—
指定表的 pg_class.relfrozenxid 字段在 VACUUM 采取非常措施以避免系统范围事务 ID 回卷失败之前所允许达到的最大年龄（以事务数计）。				现存
`vacuum_freeze_min_age`	整数	会话	`50000000`	—
指定 VACUUM 在决定是否冻结带有较旧 XID 的页面时应采用的截止年龄（以事务数计）。				现存
`vacuum_freeze_table_age`	整数	会话	`150000000`	—
如果表的 pg_class.relfrozenxid 字段达到此设置指定的年龄，VACUUM 就会执行一次激进扫描。				现存
`vacuum_max_eager_freeze_failure_rate`	浮点	会话	`0.03`	—
指定 VACUUM 在急切扫描模式下可以扫描但未能在可见性映射中设置为 all-frozen 的页面数量占整个关系总页面数的比例，超过该比例后就会禁用急切扫描。				现存
`vacuum_multixact_failsafe_age`	整数	会话	`1600000000`	—
指定表的 pg_class.relminmxid 字段在 VACUUM 采取特别措施避免系统范围的多事务 ID 回卷故障之前，所能达到的最大年龄（以多事务计）。				现存
`vacuum_multixact_freeze_min_age`	整数	会话	`5000000`	—
指定 VACUUM 在决定是否冻结带有较旧多事务 ID 的页面时应采用的截止年龄（以多事务计）。				现存
`vacuum_multixact_freeze_table_age`	整数	会话	`150000000`	—
如果表的 pg_class.relminmxid 字段达到此设置指定的年龄，VACUUM 就会执行一次激进扫描。				现存

快速链接