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