选择 打开 改范围 完整检索页

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

文档 / 配置参数 / 清理

CONFIGURATION PARAMETER清理 / 基于代价的清理延迟

vacuum_cost_page_miss

设置 VACUUM 访问缓冲区缓存未命中页面的成本。

Vacuum cost for a page not found in the buffer cache.

整数 会话 引入 9.0(基线) 现存至 20 devel 1 次默认值变更

类型
整数integer
上下文
会话任何用户都可在会话内用 SET 修改
默认值
2
取值范围
0 – 10000
引入版本
9.0(基线)
状态
现存

PostgreSQL 18 手册 官方文档

版本轨迹

相对 PostgreSQL 17 仅简述或分类有更新。

默认值变迁

10 9.0 – 13 2 14 – 20

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

手册说明

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

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

清理一个必须从磁盘上读取的缓冲区的代价。 它表示锁住缓冲池、查找共享哈希表、从磁盘读取需要的块以及扫描其内容的代价。 默认值为2。

机制详解

设置 VACUUM 访问缓冲区缓存未命中页面的成本。它可在会话级修改,因此不同会话可能采用不同的行为。

VACUUM 按页命中、未命中和弄脏操作累加虚拟成本;余额达到 vacuum_cost_limit 后按 vacuum_cost_delay 休眠并重置。该模型是粗粒度 I/O 节流,不是精确带宽上限;防回卷 failsafe 会绕过节流。

应把 vacuum_cost_page_miss 与 vacuum_cost_delay、vacuum_cost_limit、vacuum_cost_page_hit 一起监控和变更。先在对应角色与真实负载上验证,再按其 user context 选择会话修改、reload 或 restart;历史默认值并不等于当前有效值。

调优建议

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

  • OLTP在线事务处理

    用 autovacuum 时长、死元组增长和前台 I/O 延迟共同调 vacuum_cost_page_miss;优先表级覆盖热点表,避免全局节流让清理永远追不上。

  • OLAP分析与批处理

    在装载后维护窗口可提高成本额度或缩短延迟,但要验证扫描吞吐不会挤占查询/导入;failsafe 触发说明常态策略已失效。

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

    保持温和默认;若磁盘很慢,降低并发或给单表覆盖通常比无限增大 delay 更可控。

常见问题

  • 只改全局值,忽略表级 storage parameter 覆盖。
  • 把 reltuples 与累计变更统计当作精确实时计数。
  • 不看长事务、复制槽和 worker 饱和就责怪阈值。
  • 用降低维护频率换取短期平静,最终进入防回卷 failsafe。

演化历史

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

  1. PostgreSQL 20 ← 19 沿用 19

    事实沿用 19

  2. PostgreSQL 18 ← 17 仅描述更新

    分类 Resource Usage / Cost-Based Vacuum Delay Vacuuming / Cost-Based Vacuum Delay

  3. PostgreSQL 14 ← 13 默认值变更

    默认值 10 2

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
9.0 10 会话 整数 0 10000
9.1 10 会话 整数 0 10000
9.2 10 会话 整数 0 10000
9.3 10 会话 整数 0 10000
9.4 10 会话 整数 0 10000
9.5 10 会话 整数 0 10000
9.6 10 会话 整数 0 10000
10 10 会话 整数 0 10000
11 10 会话 整数 0 10000
12 10 会话 整数 0 10000
13 10 会话 整数 0 10000
14 2 会话 整数 0 10000
15 2 会话 整数 0 10000
16 2 会话 整数 0 10000
17 2 会话 整数 0 10000
18 2 会话 整数 0 10000
19 2 会话 整数 0 10000
20 沿用 2 会话 整数 0 10000

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Vacuuming 清理 5 个
基于代价的清理延迟 5
vacuum_cost_delay 浮点 会话 0 ms 121 次
设置清理成本延迟(毫秒)。 现存
vacuum_cost_limit 整数 会话 200
设置清理进程休眠前可用的成本额度。 现存
vacuum_cost_page_dirty 整数 会话 20
设置 VACUUM 弄脏一个页面的成本。 现存
vacuum_cost_page_hit 整数 会话 1
设置 VACUUM 访问缓冲区缓存命中页面的成本。 现存
vacuum_cost_page_miss 整数 会话 2 141 次
设置 VACUUM 访问缓冲区缓存未命中页面的成本。 现存