checkpoint_warning 是一个 配置参数，用于确定如果由于 WAL 文件增长而导致的 检查点 发生过于频繁时，写入日志消息的间隔。
checkpoint_warning 在 PostgreSQL 7.4 中添加。
默认值
checkpoint_warning 的默认值为：30s。
如果 checkpoint_timeout 小于 checkpoint_warning，或者 checkpoint_warning 设置为 0，则不会记录任何警告。
按 PostgreSQL 版本查看详细信息
checkpoint_warning (PostgreSQL 17)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志/检查点 |
| 简短描述 |
设置如果由 WAL 卷触发的检查点过于频繁，则发出警告之前允许的最大时间。 |
| 额外描述 |
如果由于 WAL 段文件填满而导致的检查点发生的频率高于此时间间隔，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源代码行 |
|
| 待重启 |
否 |
文档: checkpoint_warning
checkpoint_warning (PostgreSQL 16)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志/检查点 |
| 简短描述 |
设置如果由 WAL 卷触发的检查点过于频繁，则发出警告之前允许的最大时间。 |
| 额外描述 |
如果由于 WAL 段文件填满而导致的检查点发生的频率高于此时间间隔，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源代码行 |
|
| 待重启 |
否 |
文档: checkpoint_warning
checkpoint_warning (PostgreSQL 15)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志/检查点 |
| 简短描述 |
设置如果由 WAL 卷触发的检查点过于频繁，则发出警告之前允许的最大时间。 |
| 额外描述 |
如果由于 WAL 段文件填满而导致的检查点发生的频率高于此时间间隔，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源代码行 |
|
| 待重启 |
否 |
文档: checkpoint_warning
checkpoint_warning (PostgreSQL 14)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志/检查点 |
| 简短描述 |
如果检查点段的填充频率高于此值，则启用警告。 |
| 额外描述 |
如果由于检查点段文件填满而导致的检查点发生的频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源代码行 |
|
| 待重启 |
否 |
文档: checkpoint_warning
checkpoint_warning (PostgreSQL 13)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志/检查点 |
| 简短描述 |
如果检查点段的填充频率高于此值，则启用警告。 |
| 额外描述 |
如果由于检查点段文件填满而导致的检查点发生的频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源代码行 |
|
| 待重启 |
否 |
文档: checkpoint_warning
checkpoint_warning (PostgreSQL 12)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志/检查点 |
| 简短描述 |
如果检查点段的填充频率高于此值，则启用警告。 |
| 额外描述 |
如果由于检查点段文件填满而导致的检查点发生的频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源代码行 |
|
| 待重启 |
否 |
文档: checkpoint_warning
checkpoint_warning (PostgreSQL 11)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志/检查点 |
| 简短描述 |
如果检查点段的填充频率高于此值，则启用警告。 |
| 额外描述 |
如果由于检查点段文件填满而导致的检查点发生的频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源代码行 |
|
| 待重启 |
否 |
文档: checkpoint_warning
checkpoint_warning (PostgreSQL 10)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志/检查点 |
| 简短描述 |
如果检查点段的填充频率高于此值，则启用警告。 |
| 额外描述 |
如果由于检查点段文件填满而导致的检查点发生的频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源代码行 |
|
| 待重启 |
否 |
文档: checkpoint_warning
checkpoint_warning (PostgreSQL 9.6)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志/检查点 |
| 简短描述 |
如果检查点段的填充频率高于此值，则启用警告。 |
| 额外描述 |
如果由于检查点段文件填满而导致的检查点发生的频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源代码行 |
|
| 待重启 |
否 |
文档: checkpoint_warning
checkpoint_warning (PostgreSQL 9.5)
| 设置 |
30 |
| 单位 |
s |
| 类别 |
预写日志/检查点 |
| 简短描述 |
如果检查点段的填充频率高于此值，则启用警告。 |
| 额外描述 |
如果由于检查点段文件填满而导致的检查点发生的频率高于此秒数，则向服务器日志写入一条消息。零表示关闭警告。 |
| 上下文 |
sighup |
| 变量类型 |
整数 |
| 来源 |
默认 |
| 最小值 |
0 |
| 最大值 |
2147483647 |
| 枚举值 |
|
| 启动值 |
30 |
| 重置值 |
30 |
| 源文件 |
|
| 源代码行 |
|
| 待重启 |
否 |
文档: 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".
