checkpoint_segments

手册说明

官方原文 ↗

本站手册未收录此参数的说明。到官方文档查看 ↗

机制详解

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，而没有迁移到文档给出的后继参数。

演化历史

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

1. PostgreSQL 9.5 ← 9.4 移除此参数

   −该版起不再存在

逐版本快照

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

关联参数

max_wal_sizecheckpoint_timeoutcheckpoint_completion_targetwal_segment_sizemin_wal_size

参考资料

• PostgreSQL 9.4：checkpoint_segments

同类参数