checkpoint_warning 是一个 配置参数，它确定了当由 WAL 文件增长引起的 检查点 发生过于频繁时，写入日志消息的间隔。
checkpoint_warning 添加于 PostgreSQL 7.4。
默认值
checkpoint_warning 的默认值为：30s。
如果 checkpoint_timeout 小于 checkpoint_warning，或者 checkpoint_warning 设置为 0，则不会记录任何警告。
按 PostgreSQL 版本详细信息
checkpoint_warning (PostgreSQL 19)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置在检查点因 WAL 容量触发而发生过于频繁时发出警告的最大时间。 |
| 扩展描述 |
如果因 WAL 段文件增长导致的检查点发生频率高于此时间间隔，则向服务器日志写入一条消息。0 表示禁用此警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 18)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置在检查点因 WAL 容量触发而发生过于频繁时发出警告的最大时间。 |
| 扩展描述 |
如果因 WAL 段文件增长导致的检查点发生频率高于此时间间隔，则向服务器日志写入一条消息。0 表示禁用此警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 17)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置在检查点因 WAL 容量触发而发生过于频繁时发出警告的最大时间。 |
| 扩展描述 |
如果因 WAL 段文件填满导致的检查点发生频率高于此时间间隔，则向服务器日志写入一条消息。零表示关闭此警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 16)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置在检查点因 WAL 容量触发而发生过于频繁时发出警告的最大时间。 |
| 扩展描述 |
如果因 WAL 段文件填满导致的检查点发生频率高于此时间间隔，则向服务器日志写入一条消息。零表示关闭此警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 15)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
设置在检查点因 WAL 容量触发而发生过于频繁时发出警告的最大时间。 |
| 扩展描述 |
如果因 WAL 段文件填满导致的检查点发生频率高于此时间间隔，则向服务器日志写入一条消息。零表示关闭此警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 14)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 13)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 12)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 11)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 10)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 9.6)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 9.5)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
| 需要重启 |
false |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 9.4)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 9.3)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 9.2)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 9.1)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 9.0)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 8.4)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源行 |
|
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 8.3)
| 设置 |
|
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值，则启用警告。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
文档： checkpoint_warning
checkpoint_warning (PostgreSQL 8.2)
| 设置 |
|
| 单位 |
s |
| 类别 |
预写日志 / 检查点 |
| 简短描述 |
如果检查点段填满的频率高于此值（以秒为单位），则记录日志。 |
| 扩展描述 |
如果因检查点段文件填满导致的检查点发生频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
文档： checkpoint_warning
变更历史
示例
一次操作（在此例中为批量数据加载）的日志摘录，该操作生成比平时更多的检查点。
[2021-03-29 10:49:29 UTC] LOG: 00000: checkpoint starting: wal
...
[2021-03-29 10:49:34 UTC] LOG: 00000: checkpoint complete: wrote 8480 buffers (51.8%); 0 WAL file(s) added, 0 removed, 33 recycled; write=5.037 s, sync=0.001 s, total=5.043 s; sync files=0, longest=0.000 s, average=0.000 s; distance=538195 kB, estimate=538195 kB
[2021-03-29 10:49:34 UTC] LOG: 00000: checkpoints are occurring too frequently (5 seconds apart)
[2021-03-29 10:49:34 UTC] HINT: Consider increasing the configuration parameter "max_wal_size".
[2021-03-29 10:49:34 UTC] LOG: 00000: checkpoint starting: wal
...
[2021-03-29 10:49:38 UTC] LOG: 00000: checkpoint complete: wrote 807 buffers (4.9%); 0 WAL file(s) added, 3 removed, 30 recycled; write=3.906 s, sync=0.001 s, total=3.919 s; sync files=0, longest=0.000 s, average=0.000 s; distance=540689 kB, estimate=540689 kB
[2021-03-29 10:49:38 UTC] LOG: 00000: checkpoints are occurring too frequently (4 seconds apart)
[2021-03-29 10:49:38 UTC] HINT: Consider increasing the configuration parameter "max_wal_size".
[2021-03-29 10:49:38 UTC] LOG: 00000: checkpoint starting: wal
...
[2021-03-29 10:49:39 UTC] LOG: 00000: checkpoint complete: wrote 384 buffers (2.3%); 0 WAL file(s) added, 3 removed, 30 recycled; write=0.394 s, sync=0.001 s, total=0.430 s; sync files=0, longest=0.000 s, average=0.000 s; distance=549825 kB, estimate=549825 kB
[2021-03-29 10:49:39 UTC] LOG: 00000: checkpoints are occurring too frequently (1 second apart)
[2021-03-29 10:49:39 UTC] HINT: Consider increasing the configuration parameter "max_wal_size".
