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

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

百科 / 配置参数 / 资源消耗

CONFIGURATION PARAMETER资源消耗 / 异步行为

old_snapshot_threshold

设置快照因过旧而不能读取后来被修改页面的时间阈值。

Time before a snapshot is too old to read pages changed after the snapshot was taken.

整数 重启生效 引入 9.6 于 17 移除 0 次默认值变更

类型
整数integer
上下文
重启生效只能在服务器启动时设置,修改后需要重启
默认值
-1 min原始值 -1 min
取值范围
-1 – 86400
引入版本
9.6
状态
于 17 移除

PostgreSQL 16 手册 官方文档 引入提交 848ef42bb8

版本轨迹

相对 PostgreSQL 15 无变化。

默认值变迁

-1 min 9.6 – 16

已记录的默认值在 PostgreSQL 9.6–16 之间未变。带单位的取值换算成了可读形式,原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 16 手册 · 20.4 资源消耗 本站手册 官方原文

本版译文与 PostgreSQL 12 完全一致,下面就是同一段文字。

设置查询快照在使用时不发生“snapshot too old”错误的最短可用时间。已死亡超过该阈值的数据允许被清理掉。这有助于在快照长期保持使用时防止膨胀。为了避免因清理本应对该快照可见的数据而得到错误结果,当快照年龄超过该阈值,并且该快照被用于读取某个自其建立以来已被修改过的页面时,就会报错。

如果指定值时没有单位,则以分钟为单位。值为 -1(默认值)会禁用此特性,相当于把快照年龄上限设为无穷大。该参数只能在服务器启动时设置。

对生产环境而言,有用的取值大概从几个小时到几天不等。较小的值(例如 0 或 1min)之所以被允许,只是因为它们有时可用于测试。虽然允许设置到 60d 这么高,但请注意,在许多工作负载中,严重膨胀或事务 ID 回卷可能会在更短时间内发生。

启用此特性后,关系末尾释放出来的空间将不能返还给操作系统,因为那样可能会移除检测“snapshot too old”条件所需的信息。分配给某个关系的全部空间都会一直归属于该关系,只能在该关系内部重用,除非显式释放(例如使用 VACUUM FULL)。

该设置并不尝试保证在任何特定情况下都一定会产生错误。实际上,如果仍能从某个对象(例如已经物化结果集的游标)生成正确结果,那么即使被引用表中的底层行已经被清理掉,也不会报错。有些表不能安全地提前清理,因此不会受此设置影响,例如系统目录。对这类表来说,此设置既不会减少膨胀,也不会在扫描时引入“snapshot too old”错误的可能性。

机制详解

old_snapshot_threshold 在 PG16 及以前可用、PG17 移除;它在配置时间后把快照标为过旧,让页面清理更积极,后续读取可能报 snapshot-too-old,而不是取得历史页面版本。

它不是事务超时:事务可继续运行,直到访问旧版本已被清除的数据。即使尚未出现错误,该功能也需要在启动时启用跟踪开销。

它不能替代正确 vacuum,也不能避免所有膨胀。由于功能已移除,迁移到 PG17+ 时不能携带该参数,应用也不能依赖其报错语义。其 postmaster 上下文在服务器启动时固定取值,修改后必须重启。

调优建议

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

  • OLTP在线事务处理

    当前 PostgreSQL 不应调优 old_snapshot_threshold:升级目标中应删除它,并采用上文所述当前替代行为;只有复现历史版本时才保留。

  • OLAP分析与批处理

    不要把 old_snapshot_threshold 带入现代分析集群,应测试受支持的当前机制,而不是模拟已移除实现细节。

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

    版本迁移时删除 old_snapshot_threshold;它更可能造成未知参数启动失败,而不是带来收益。历史测试实例应保留旧版本上游默认。

常见问题

  • 修改 old_snapshot_threshold 时忽略文档单位与配置生效上下文。
  • 只优化孤立基准,却忽略并发后的资源总量。
  • 认为配置值能够保证操作系统或存储层实际行为。
  • 修改后没有重新验证启动、故障转移与负载延迟。

演化历史

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

  1. PostgreSQL 17 ← 16 移除此参数

    该版起不再存在

  2. PostgreSQL 9.6 ← 9.5 新增此参数

    PostgreSQL 9.6 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
9.6 -1 min min 重启生效 整数 -1 86400 —
10 -1 min min 重启生效 整数 -1 86400 —
11 -1 min min 重启生效 整数 -1 86400 —
12 -1 min min 重启生效 整数 -1 86400 —
13 -1 min min 重启生效 整数 -1 86400 —
14 -1 min min 重启生效 整数 -1 86400 —
15 -1 min min 重启生效 整数 -1 86400 —
16 -1 min min 重启生效 整数 -1 86400 —

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Resource Usage 资源消耗 1 个 ↗
异步行为 1
old_snapshot_threshold 整数 重启生效 -1 min —
设置快照因过旧而不能读取后来被修改页面的时间阈值。 于 17 移除