wal_skip_threshold

手册说明

PostgreSQL 18 手册 · 19.5 预写式日志 本站手册 官方原文 ↗

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

机制详解

设置用 fsync 新文件代替写 WAL 的最小文件规模。它可在会话级修改，因此不同会话可能采用不同的行为。

它位于 WAL 生成、写出、检查点、归档与恢复链路中；实际效果还受 wal_level、检查点节奏、持久化设置与存储语义影响。只观察单一参数不足以证明耐久性或恢复能力。

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

调优建议

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

• OLTP在线事务处理

  先保证耐久性与恢复目标，再以 WAL 生成速率、刷写延迟、检查点和 pg_wal 峰值调 wal_skip_threshold；每次改动都做崩溃/恢复与归档监控验证。

• OLAP分析与批处理

  按批量装载峰值规划 WAL、归档带宽和恢复 I/O；需要降低峰值时应协调装载节奏与检查点，而不是牺牲恢复链。

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

  从安全默认开始，按有限磁盘容量设置明确告警；不要仅为节省少量 I/O 就关闭耐久性或破坏恢复链。

常见问题

• 在 wal_level=replica 或 logical 下调优；此时该参数没有作用。
• 把它应用到普通行修改，而它只涉及新建或重写的关系文件。
• 把未带单位的值读成字节，而不是 kB。
• 未基于真实存储与并发提交影响测试，就在 fsync 与写 WAL 之间作选择。

演化历史

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

1. PostgreSQL 20 ← 19 沿用 19

   事实沿用 19

2. PostgreSQL 14 ← 13 仅描述更新

   简述 Size of new file to fsync instead of writing WAL. → Minimum size of new file to fsync instead of writing WAL.

3. PostgreSQL 13 ← 12 新增此参数

   +PostgreSQL 13 起可用

逐版本快照

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

关联参数

commit_delaycommit_siblingsfsyncfull_page_writessynchronous_commitwal_buffers

参考资料

• PostgreSQL 19 Beta 3：wal_skip_threshold
• PostgreSQL 19 发行说明

同类参数