CONFIGURATION PARAMETER预写式日志 / 恢复
wal_decode_buffer_size
设置恢复期间超前读取 WAL 的缓冲区大小。
Buffer size for reading ahead in the WAL during recovery.
整数 重启生效 引入 15 现存至 20 devel 0 次默认值变更
- 类型
- 整数integer
- 上下文
- 重启生效只能在服务器启动时设置，修改后需要重启
- 默认值
512 KiB原始值 524288 B- 取值范围
65536 – 1073741823- 分类
- 预写式日志 / 恢复
- 引入版本
- 15
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 15 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本版译文与 PostgreSQL 16 完全一致，下面就是同一段文字。
服务器可以在WAL中查找预取块的最大提前量限制。如果未指定单位，则将其视为字节。 默认值为512kB。该参数只能在服务器启动时设置。
机制详解
设置恢复期间超前读取 WAL 的缓冲区大小。该值在服务器启动时固定，修改后必须重启。
它位于 WAL 生成、写出、检查点、归档与恢复链路中；实际效果还受 wal_level、检查点节奏、持久化设置与存储语义影响。只观察单一参数不足以证明耐久性或恢复能力。
应把 wal_decode_buffer_size 与 recovery_prefetch、maintenance_io_concurrency、effective_io_concurrency 一起监控和变更。先在对应角色与真实负载上验证，再按其 postmaster context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
在与生产相同的存储上用恢复/备库追赶基准调 wal_decode_buffer_size，同时观察 replay I/O wait、缓存命中与 maintenance_io_concurrency；没有测量收益就保留默认。
-
OLAP分析与批处理
大型数据集且随机读取较慢时可能收益更大，但过度预取会挤占查询 I/O 与缓存；在故障恢复与读备库两种场景分别测试。
-
小规格低配实例与开发机
默认通常足够。内存与 I/O 队列有限时，不要为扩大超前窗口占用资源，除非恢复时间目标有明确缺口。
常见问题
- 混淆 pg_settings 的原始单位与配置文件可读单位。
- 只做吞吐基准，不做崩溃恢复与归档还原。
- 忽略检查点、复制槽或归档失败造成的联动。
- 在需要 restart 的参数上只 reload 就认为已生效。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 15 ← 14 新增此参数
PostgreSQL 15 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 恢复 2 | |||||
recovery_prefetch |
枚举 | 重载生效 | try |
— | |
| 在恢复期间预取 WAL 引用的数据块。 | 现存 | ||||
wal_decode_buffer_size |
整数 | 重启生效 | 512 KiB |
— | |
| 设置恢复期间超前读取 WAL 的缓冲区大小。 | 现存 | ||||