CONFIGURATION PARAMETER预写式日志 / 检查点

checkpoint_segments

自动 WAL 检查点之间日志文件段的最大数量（每个段通常为 16 兆字节）。

Sets the maximum distance in log segments between automatic WAL checkpoints.

整数重载生效引入 7.4（基线）于 9.5 移除 0 次默认值变更

类型: 整数integer
上下文: 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
默认值: 3
取值范围: 1 – 2147483647
分类: 预写式日志 / 检查点
引入版本: 7.4（基线）
状态: 于 9.5 移除

PostgreSQL 9.4 手册官方文档

版本轨迹

相对 PostgreSQL 9.3 无变化。

默认值变迁

3 9.0 – 9.4

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

手册说明

PostgreSQL 9.4 手册 · 18.5 预写式日志本站手册官方原文

自动 WAL 检查点之间日志文件段的最大数量（每个段通常为 16 兆字节）。默认值为三个段。增加这个参数会增加崩溃恢复所需的时间。此参数只能在postgresql.conf文件中或服务器命令行上设置。

机制详解

checkpoint_segments：设置两次自动 WAL 检查点之间允许的最大日志段距离。重新加载配置即可让服务器采用新值，无需完整重启。本站在 PG9.0–9.4 实测到它；boot_val 是编译或初始化基线，并不能证明某个运行集群的当前有效值。

这是 PostgreSQL 9.5 之前的检查点容量控制：累计 WAL 接近指定段数时请求自动检查点。PG9.5 以 max_wal_size 取代它；新参数使用软性的字节容量预算，并与 checkpoint_timeout、checkpoint_completion_target 协同，而不是直接暴露 WAL 段数。

应与 max_wal_size、checkpoint_timeout、checkpoint_completion_target、wal_segment_size 一起理解。请在目标服务器检查 SHOW 与 pg_settings，确认 source 和 pending_restart，并在修改前后对比真实负载、日志和资源指标。

调优建议

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

OLTP在线事务处理

不要把这个已退出的名称加入现代 OLTP 配置。应把原意迁移到文档给出的后继参数，在连接与写并发下验证，并清理仍会输出旧名称的自动化。
OLAP分析与批处理

升级分析型环境前应盘点所有生成配置，把旧控制映射到后继项，并比较执行计划、吞吐、WAL 或日志行为；不能假设旧数值可直接搬用。
小规格低配实例与开发机

记录旧覆盖存在的原因后将其删除。小节点应先采用后继参数默认值，实测后再调整；未知的启动参数可能直接阻止服务器启动。

常见问题

把 checkpoint_segments 的实测 boot_val 当成初始化后或托管集群当前有效值的证明。
忽略 pg_settings 报告的 sighup context，误以为修改会立即生效。
孤立修改该参数，没有检查关联上限、可观测性和回滚路径。
把已移除名称复制到现代 postgresql.conf，而没有迁移到文档给出的后继参数。

演化历史

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

PostgreSQL 9.5 ← 9.4 移除此参数

该版起不再存在

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
7.4	—	—	—	`整数`	—	—	—
8.0	—	—	—	`整数`	—	—	—
8.1	—	—	—	`整数`	—	—	—
8.2	—	—	—	`整数`	—	—	—
8.3	—	—	—	`整数`	—	—	—
8.4	—	—	—	`整数`	—	—	—
9.0	`3`	`空`	`重载生效`	`整数`	`1`	`2147483647`	`—`
9.1	`3`	`空`	`重载生效`	`整数`	`1`	`2147483647`	`—`
9.2	`3`	`空`	`重载生效`	`整数`	`1`	`2147483647`	`—`
9.3	`3`	`空`	`重载生效`	`整数`	`1`	`2147483647`	`—`
9.4	`3`	`空`	`重载生效`	`整数`	`1`	`2147483647`	`—`

参考资料

PostgreSQL 9.4：checkpoint_segments

同类参数

参数	类型	上下文	默认值	最近变更
Write-Ahead Log 预写式日志 7 个 ↗
检查点 7
`checkpoint_completion_target`	浮点	重载生效	`0.9`	141 次
指定检查点完成所用时间的目标值，以检查点之间总时间的比例表示。				现存
`checkpoint_flush_after`	整数	重载生效	`256 KiB (32 × 8kB)`	—
当执行检查点时写入的数据量超过此数量时，就尝试强制 OS 把这些写发送到底层存储。				现存
`checkpoint_segments`	整数	重载生效	`3`	—
自动 WAL 检查点之间日志文件段的最大数量（每个段通常为 16 兆字节）。				于 9.5 移除
`checkpoint_timeout`	整数	重载生效	`5 min`	9.61 次
自动 WAL 检查点之间的最长时间。				现存
`checkpoint_warning`	整数	重载生效	`30 s`	—
如果由于填充 WAL 段文件导致的检查点之间的间隔低于这个参数表示的时间量，那么就向服务器日志写一个消息（它建议增加 max_wal_size 的值）。				现存
`max_wal_size`	整数	重载生效	`1 GiB`	101 次
在自动检查点期间允许 WAL 增长的最大大小。				现存
`min_wal_size`	整数	重载生效	`80 MiB`	101 次
只要 WAL 磁盘用量保持在这个设置之下，在检查点时旧的 WAL 文件总是被回收以便未来使用，而不是直接被删除。				现存

快速链接