↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / 配置参数 / 清理

CONFIGURATION PARAMETER清理 / 冻结

vacuum_multixact_freeze_min_age

指定 VACUUM 在决定是否冻结带有较旧多事务 ID 的页面时应采用的截止年龄(以多事务计)。

Minimum age at which VACUUM should freeze a MultiXactId in a table row.

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

类型
整数integer
上下文
会话任何用户都可在会话内用 SET 修改
默认值
5000000
取值范围
0 – 1000000000
引入版本
9.3
状态
现存

PostgreSQL 18.7 手册 官方文档 引入提交 fb47de2be6

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

5000000 9.3 – 9.4 5000000 9.5 – 19

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

手册说明

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

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

机制详解

设置 VACUUM 替换元组 xmax 中旧 MultiXact ID 时采用的最小 MXID 年龄。它是 user context,并与 XID 截止点相互独立。

较小值使 VACUUM 更早处理 MXID,较大值推迟该工作。PostgreSQL 仍可能主动移除 MultiXact;有效截止点最高为 autovacuum_multixact_freeze_max_age 的一半。

监控 mxid_age(relminmxid)、mxid_age(datminmxid) 与 pg_multixact member 空间。应与 vacuum_multixact_freeze_table_age、autovacuum_multixact_freeze_max_age、vacuum_multixact_failsafe_age 联合解释。

调优建议

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

  • OLTP在线事务处理

    依据行锁与多事务负载产生的 MXID 消耗调优。与 autovacuum_multixact_freeze_max_age 保持充足距离,并同时监控 member 空间与年龄。

  • OLAP分析与批处理

    单纯批量读取通常不需要修改,但并发行锁装载可能快速消耗 MXID;应在真实负载中测量 mxid_age 与 pg_multixact 增长。

  • 小规格低配实例与开发机

    没有 MXID 证据就保持默认。事务量低并不代表大量共享行锁的工作负载安全。

常见问题

  • 把该截止点描述成 XID 控制,或只监控 relfrozenxid。
  • 忽略 pg_multixact member 空间压力;它可能在配置年龄前就强制 aggressive 工作。
  • 长期共享行锁持续产生旧 MXID 时仍提高该值。
  • 计算上限时误用 autovacuum_freeze_max_age,而不是 MultiXact 专用上限。

演化历史

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

  1. PostgreSQL 9.3 ← 9.2 新增此参数

    PostgreSQL 9.3 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
9.3 5000000 空 会话 整数 0 1000000000 —
9.4 5000000 空 会话 整数 0 1000000000 —
9.5 5000000 — 会话 整数 0 1000000000 —
9.6 5000000 — 会话 整数 0 1000000000 —
10 5000000 — 会话 整数 0 1000000000 —
11 5000000 — 会话 整数 0 1000000000 —
12 5000000 — 会话 整数 0 1000000000 —
13 5000000 — 会话 整数 0 1000000000 —
14 5000000 — 会话 整数 0 1000000000 —
15 5000000 — 会话 整数 0 1000000000 —
16 5000000 — 会话 整数 0 1000000000 —
17 5000000 — 会话 整数 0 1000000000 —
18 5000000 — 会话 整数 0 1000000000 —
19 5000000 — 会话 整数 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 就会执行一次激进扫描。 现存