CONFIGURATION PARAMETER预写式日志 / 归档
archive_command
设置归档 WAL 文件时调用的 shell 命令。
Sets the shell command that will be called to archive a WAL file.
字符串 重载生效 引入 9.0（基线） 现存至 20 devel 0 次默认值变更
- 类型
- 字符串string
- 上下文
- 重载生效改配置文件后重载（pg_ctl reload / SIGHUP）即可生效
- 默认值
空字符串原始值 ''- 分类
- 预写式日志 / 归档
- 引入版本
- 9.0（基线）
- 状态
- 现存
版本轨迹
相对 PostgreSQL 17 仅简述或分类有更新。
默认值变迁
已记录的默认值在 PostgreSQL 9.0–20 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
本地 shell 命令被执行来归档一个完成的 WAL 段文件。字符串中的任何%p被替换成要被归档的文件的路径名，而%f只被文件名替换（路径名是相对于服务器的工作目录，即集簇的数据目录）。如果要在命令里嵌入一个真正的%字符，可以使用%%。有一点很重要，该命令只在成功时返回一个零作为退出状态。更多信息请见第 25.3.1 节。
这个参数只能在postgresql.conf文件或服务器命令行中设置。除非在服务器启动时启用了archive_mode并且archive_library设置为空字符串，否则将被忽略。如果archive_command和archive_library都被设置，则会报错。如果archive_command是空字符串（默认值），而archive_mode已启用（并且archive_library设置为空字符串），WAL归档将暂时被禁用，但服务器将继续积累WAL段文件，期望很快会提供命令。将archive_command设置为一个什么都不做但返回true的命令，例如/bin/true（Windows上为REM），实际上禁用了归档，但也破坏了用于归档恢复所需的WAL文件链，因此只应在不寻常的情况下使用。
机制详解
设置归档 WAL 文件时调用的 shell 命令。重新加载配置即可应用新值；已经开始的工作不会被追溯改变。
归档进程把 %p 展开为源路径、%f 展开为 WAL 文件名，并把退出码 0 当作持久成功；非零会重试。虚假成功会允许 PostgreSQL 回收唯一的本地副本，悄然破坏归档链。
应把 archive_command 与 archive_mode、archive_library、archive_timeout 一起监控和变更。先在对应角色与真实负载上验证，再按其 sighup context 选择会话修改、reload 或 restart；历史默认值并不等于当前有效值。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
把 archive_command 作为备份/恢复协议的一部分管理：命令或模块必须幂等、失败可见，并通过从真实归档恢复来验证，而不是只看返回码。
-
OLAP分析与批处理
按批量装载 WAL 峰值配置归档吞吐与容量；归档跟不上时节流任务并报警，不能用虚假成功或激进清理掩盖积压。
-
小规格低配实例与开发机
有明确 PITR 需求才启用并交给成熟备份工具；可重建实例保持简单，但不要留下占位命令制造“已备份”的错觉。
常见问题
- 归档副本尚未持久化或校验就返回成功。
- shell 命令没有安全引用 %p/%f。
- 反复失败写满 pg_wal 并使服务器停摆。
- 混淆 pg_settings 的原始单位与配置文件可读单位。
- 只做吞吐基准，不做崩溃恢复与归档还原。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 18 ← 17 仅描述更新
补充说明
This is used only if "archive_library" is not set.An empty string means use "archive_library". -
PostgreSQL 15 ← 14 仅描述更新
补充说明
（无）This is used only if "archive_library" is not set.
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.0 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 9.1 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 9.2 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 9.3 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 9.4 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 9.5 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 9.6 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 10 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 11 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 12 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 13 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 14 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 15 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 16 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 17 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 18 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 19 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
| 20 沿用 | 空字符串 |
— |
重载生效 |
字符串 |
— |
— |
— |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
| 归档 4 | |||||
archive_command |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置归档 WAL 文件时调用的 shell 命令。 | 现存 | ||||
archive_library |
字符串 | 重载生效 | 空字符串 |
— | |
| 设置归档 WAL 文件时调用的库。 | 现存 | ||||
archive_mode |
枚举 | 重启生效 | off |
9.51 次 | |
| 允许使用 archive_command 归档 WAL 文件。 | 现存 | ||||
archive_timeout |
整数 | 重载生效 | 0 s |
— | |
| 设置强制切换到下一个 WAL 文件前的最长等待时间。 | 现存 | ||||