目录

log_truncate_on_rotation

一个决定日志文件是否在轮转时截断的 GUC 参数

log_truncate_on_rotation 是一个 配置参数，用于决定日志文件在轮转时是否应该被截断。

log_truncate_on_rotation 在 PostgreSQL 8.0 中被添加。

默认

log_truncate_on_rotation 的默认值为：off。

用法

如果启用，在切换（轮转）日志文件时，如果存在同名的日志文件，PostgreSQL 将截断该文件，从而覆盖它。

请注意，截断只会在由于基于时间的轮转而创建新日志文件时发生，而不是在服务器启动或基于大小的轮转期间。

PostgreSQL 不会发出任何日志消息来指示它已截断现有文件。

要使 log_truncate_on_rotation 生效，必须启用 logging_collector。

按 PostgreSQL 版本详细信息

log_truncate_on_rotation (PostgreSQL 19)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 18)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 17)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 16)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 15)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 14)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 13)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 12)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 11)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 10)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 9.6)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 9.5)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  
需要重启 false

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 9.4)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 9.3)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 9.2)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 9.1)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 9.0)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 8.4)

设置 off
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  
枚举值  
启动值 off
重置值 off
源文件  
源行  

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 8.3)

设置  
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  

文档：log_truncate_on_rotation

log_truncate_on_rotation (PostgreSQL 8.2)

设置  
单位  
类别 报告和日志记录 / 日志记录位置
简短描述 日志轮转期间截断同名的现有日志文件。
扩展描述  
上下文 sighup
变量类型 bool
来源 默认
最小值  
最大值  

文档：log_truncate_on_rotation

变更历史

示例

日志配置如下

logging_collector = on
log_filename = 'postgresql-%a.log'
log_rotation_age = 1440
log_truncate_on_rotation = on

六天后，PostgreSQL 会为一周的每一天生成一个日志文件。

postgresql-Mon.log
postgresql-Tue.log
postgresql-Wed.log
postgresql-Thu.log
postgresql-Fri.log
postgresql-Sat.log
postgresql-Sun.log

后续的日志轮转将覆盖当天的文件，这意味着将保留六天的日志。

分类

GUC 配置项, 日志记录

另请参阅

logging_collector, log_filename, log_rotation_age, log_rotation_size

反馈

提交关于“log_truncate_on_rotation”的任何评论、建议或更正请在此处 提交。