CONFIGURATION PARAMETER清理 / 冻结
vacuum_freeze_min_age
设置 VACUUM 冻结表行所需的最小年龄。
Minimum age at which VACUUM should freeze a table row.
整数 会话 引入 9.0（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 会话任何用户都可在会话内用 SET 修改
- 默认值
50000000- 取值范围
0 – 1000000000- 分类
- 清理 / 冻结
- 引入版本
- 9.0（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 仅简述或分类有更新。
默认值变迁
已记录的默认值在 PostgreSQL 9.0–20 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
指定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 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 仅描述更新
分类
Client Connection Defaults / Statement BehaviorVacuuming / Freezing
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 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 沿用 | 50000000 |
— |
会话 |
整数 |
0 |
1000000000 |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 冻结 7 | |||||
vacuum_failsafe_age |
整数 | 会话 | 1600000000 |
— | |
| 设置 VACUUM 为避免事务 ID 回卷停机而进入保护模式的年龄。 | 现存 | ||||
vacuum_freeze_min_age |
整数 | 会话 | 50000000 |
— | |
| 设置 VACUUM 冻结表行所需的最小年龄。 | 现存 | ||||
vacuum_freeze_table_age |
整数 | 会话 | 150000000 |
— | |
| 设置 VACUUM 为冻结元组而扫描整张表的年龄。 | 现存 | ||||
vacuum_max_eager_freeze_failure_rate |
浮点 | 会话 | 0.03 |
— | |
| 设置 VACUUM 在关闭积极冻结扫描前，允许扫描但未能冻结的页面比例。 | 现存 | ||||
vacuum_multixact_failsafe_age |
整数 | 会话 | 1600000000 |
— | |
| 设置 VACUUM 为避免 MultiXact 回卷停机而进入保护模式的年龄。 | 现存 | ||||
vacuum_multixact_freeze_min_age |
整数 | 会话 | 5000000 |
— | |
| 设置 VACUUM 冻结表行中 MultiXactId 所需的最小年龄。 | 现存 | ||||
vacuum_multixact_freeze_table_age |
整数 | 会话 | 150000000 |
— | |
| 设置 VACUUM 为冻结 MultiXact 而扫描整张表的年龄。 | 现存 | ||||