checkpoint_timeout 是一个 配置参数，用于定义自动 WAL 检查点之间的最大时间。
checkpoint_timeout 在 PostgreSQL 7.1 中添加。
默认值
checkpoint_timeout 的默认值是：5min。
日志输出
由超时触发的自动检查点的典型日志输出（当 log_checkpoints 设置为“on”时）
[2021-03-29 03:30:48 UTC] LOG: checkpoint starting: time
[2021-03-29 03:31:14 UTC] LOG: checkpoint complete: wrote 253 buffers (0.1%); 1 WAL file(s) added, 0 removed, 0 recycled; write=25.697 s, sync=0.014 s, total=25.838 s; sync files=87, longest=0.003 s, average=0.000 s; distance=1464 kB, estimate=5249 kB
按 PostgreSQL 版本详细信息
checkpoint_timeout (PostgreSQL 19)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 18)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 17)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 16)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 15)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 14)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 13)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 12)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 11)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 10)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 9.6)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
86400 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 9.5)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
3600 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 9.4)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
3600 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 9.3)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
3600 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 9.2)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
3600 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 9.1)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
3600 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 9.0)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
3600 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 8.4)
| 设置 |
300 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
3600 |
| 枚举值 |
|
| 启动值 |
300 |
| 重置值 |
300 |
| 源文件 |
|
| 源行 |
|
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 8.3)
| 设置 |
|
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大时间。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
3600 |
文档：checkpoint_timeout
checkpoint_timeout (PostgreSQL 8.2)
| 设置 |
|
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置自动 WAL 检查点之间的最大秒数。 |
| 扩展描述 |
|
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
30 |
| 最大值 |
3600 |
文档：checkpoint_timeout
变更历史
