archive_timeout

手册说明

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

机制详解

设置强制切换到下一个 WAL 文件前的最长等待时间。重新加载配置即可应用新值；已经开始的工作不会被追溯改变。

在间隔内没有自然换段时，PostgreSQL 强制切换 WAL 段以便归档当前部分。它不会让 WAL 更早持久化；过小会产生大量未写满但仍占完整段空间的归档文件。

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

调优建议

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

• OLTP在线事务处理

  把 archive_timeout 作为备份/恢复协议的一部分管理：命令或模块必须幂等、失败可见，并通过从真实归档恢复来验证，而不是只看返回码。

• OLAP分析与批处理

  按批量装载 WAL 峰值配置归档吞吐与容量；归档跟不上时节流任务并报警，不能用虚假成功或激进清理掩盖积压。

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

  有明确 PITR 需求才启用并交给成熟备份工具；可重建实例保持简单，但不要留下占位命令制造“已备份”的错觉。

常见问题

• 把它误当成提交持久化超时。
• 间隔过小，制造大量几乎为空却占完整段空间的归档文件。
• 误以为强制换段能解决归档进程缓慢或失败。
• 混淆 pg_settings 的原始单位与配置文件可读单位。
• 只做吞吐基准，不做崩溃恢复与归档还原。

演化历史

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

1. PostgreSQL 20 ← 19 沿用 19

   事实沿用 19

2. PostgreSQL 18 ← 17 仅描述更新

   补充说明 （无） → 0 disables the timeout.

3. PostgreSQL 15 ← 14 仅描述更新

   简述 Forces a switch to the next WAL file if a new file has not been started within N seconds. → Sets the amount of time to wait before forcing a switch to the next WAL file.

4. PostgreSQL 10 ← 9.6 仅描述更新

   简述 Forces a switch to the next xlog file if a new file has not been started within N seconds. → Forces a switch to the next WAL file if a new file has not been started within N seconds.

逐版本快照

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

关联参数

archive_modearchive_commandarchive_libraryarchive_cleanup_commandrestore_commandrecovery_end_command

参考资料

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

同类参数