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

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

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

CONFIGURATION PARAMETER资源消耗 / 内存

vacuum_buffer_usage_limit

指定 VACUUM 和 ANALYZE 命令使用的缓冲区访问策略的大小。

Sets the buffer pool size for VACUUM, ANALYZE, and autovacuum.

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

类型
整数integer
上下文
会话任何用户都可在会话内用 SET 修改
默认值
2 MiB原始值 2048 kB
取值范围
0 – 16777216
分类
资源消耗 / 内存
引入版本
16
状态
现存

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

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

256 KiB 16 2 MiB 17 – 19

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

手册说明

PostgreSQL 18.7 手册 · 19.4 资源消耗 本站手册 官方原文

指定 VACUUM 和 ANALYZE 命令使用的缓冲区访问策略的大小。设为 0 时，允许操作使用任意数量的 shared_buffers 缓冲区。否则，有效大小范围为 128 kB 至 16 GB。如果指定的大小超过 shared_buffers 大小的 1/8，则会在不提示的情况下限制为该值。默认值为 2MB。如果未指定单位，则以千字节为单位。此参数可以随时设置。在执行 VACUUM 和 ANALYZE 时，可以通过 BUFFER_USAGE_LIMIT 选项覆盖此设置。较大的设置可能使 VACUUM 和 ANALYZE 运行得更快，但设置过大可能会将过多其他有用页面逐出共享缓冲区。

机制详解

vacuum_buffer_usage_limit 设置 VACUUM、ANALYZE 与 autovacuum 使用的共享缓冲区访问策略环大小。它不是私有内存分配，也不限制这些操作一共能触碰多少缓冲区。

非零值会被静默限制为 shared_buffers 的八分之一；零允许不受环限制地使用共享缓冲区。该环在扫描期间反复复用，同时减少驱逐无关热点页面。

较大环可能提高维护吞吐，也会挤掉更多有用缓存。VACUUM 与 ANALYZE 可用 BUFFER_USAGE_LIMIT 按命令覆盖；启动默认从 PG16 的 256kB 提高到 PG17 的 2MB。其 user 上下文允许按会话或事务局部修改，之后执行或重新规划的工作会读取新值。

调优建议

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

  • OLTP在线事务处理

    只有在并发下定位到对应资源瓶颈后才修改 vacuum_buffer_usage_limit。应预算总内存、I/O、磁盘或内核容量，而不是孤立优化一个进程。

  • OLAP分析与批处理

    使用代表性的批处理与扫描阶段测试 vacuum_buffer_usage_limit，同时观察持续吞吐、落盘/回写及对其他会话的干扰，不能只看单次操作耗时。

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

    小主机上应保守设置 vacuum_buffer_usage_limit；证据不足时优先上游默认。照搬大服务器取值可能占用不成比例的资源。

常见问题

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

演化历史

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

  1. PostgreSQL 17 ← 16 默认值变更

    默认值 256 KiB 2 MiB

  2. PostgreSQL 16 ← 15 新增此参数

    PostgreSQL 16 起可用

逐版本快照

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

版本 默认值单位上下文类型最小值最大值枚举值
16 256 KiB kB 会话 整数 0 16777216 —
17 2 MiB kB 会话 整数 0 16777216 —
18 2 MiB kB 会话 整数 0 16777216 —
19 2 MiB kB 会话 整数 0 16777216 —
20 — — — 整数 — — —

参考资料

同类参数

参数 类型 上下文 默认值 版本变动 最近变更
Resource Usage 资源消耗 23 个 ↗
内存 23
autovacuum_work_mem 整数 重载生效 -1 kB —
指定每个自动清理工作进程可使用的最大内存量。 现存
commit_timestamp_buffers 整数 重启生效 0 B (0 × 8kB) —
指定用于缓存 pg_commit_ts 内容的内存量（参见表 66.1）。 现存
dynamic_shared_memory_type 枚举 重启生效 posix 121 次
指定服务器应使用的动态共享内存实现。 现存
hash_mem_multiplier 浮点 会话 2 151 次
用于计算基于 hash 的操作可以使用的最大内存量。 现存
huge_page_size 整数 重启生效 0 B —
控制通过 huge_pages 启用巨型页时所使用的页大小。 现存
huge_pages 枚举 重启生效 try —
控制是否为主共享内存区域请求巨型页。 现存
logical_decoding_work_mem 整数 会话 64 MiB —
指定逻辑解码在将部分已解码的更改写入本地磁盘之前可使用的最大内存量。 现存
maintenance_work_mem 整数 会话 64 MiB 172 次
指定维护操作（如 VACUUM、CREATE INDEX 和 ALTER TABLE ADD FOREIGN KEY）可使用的最大内存量。 现存
max_prepared_transactions 整数 重启生效 0 9.62 次
设置可同时处于“预备”状态的事务的最大数量（见 PREPARE TRANSACTION）。 现存
max_stack_depth 整数 会话（超级用户） 100 KiB —
指定服务器执行栈的最大安全深度。 现存
min_dynamic_shared_memory 整数 重启生效 0 B —
指定服务器启动时为并行查询分配的内存量。 现存
multixact_member_buffers 整数 重启生效 256 KiB (32 × 8kB) —
指定用于缓存 pg_multixact/members 内容的共享内存量（参见表 66.1）。 现存
multixact_offset_buffers 整数 重启生效 128 KiB (16 × 8kB) —
指定用于缓存 pg_multixact/offsets 内容的共享内存量（参见表 66.1）。 现存
notify_buffers 整数 重启生效 128 KiB (16 × 8kB) —
指定用于缓存 pg_notify 内容的共享内存量（参见表 66.1）。 现存
replacement_sort_tuples 整数 会话 150000 —
当待排序的元组数小于此数值时，排序会使用置换选择而非快速排序来产生第一个输出有序段。 于 11 移除
serializable_buffers 整数 重启生效 256 KiB (32 × 8kB) —
指定用于缓存 pg_serial 内容的共享内存量（参见表 66.1）。 现存
shared_buffers 整数 重启生效 128 MiB (16384 × 8kB) 151 次
设置数据库服务器用于共享内存缓冲区的内存量。 现存
shared_memory_type 枚举 重启生效 mmap —
指定服务器用于主共享内存区域的共享内存实现，该区域存放 PostgreSQL 的共享缓冲区及其他共享数据。 现存
subtransaction_buffers 整数 重启生效 0 B (0 × 8kB) —
指定用于缓存 pg_subtrans 内容的共享内存量（参见表 66.1）。 现存
temp_buffers 整数 会话 8 MiB (1024 × 8kB) —
设置每个数据库会话用于临时缓冲区的最大内存量。 现存
transaction_buffers 整数 重启生效 0 B (0 × 8kB) —
指定用于缓存 pg_xact 内容的共享内存量（参见表 66.1）。 现存
vacuum_buffer_usage_limit 整数 会话 2 MiB 171 次
指定 VACUUM 和 ANALYZE 命令使用的缓冲区访问策略的大小。 现存
work_mem 整数 会话 4 MiB 9.41 次
设置查询操作（如排序或 hash 表）在写入临时磁盘文件之前可使用的基础最大内存量。 现存