log_timezone 是一个 配置参数,用于确定 PostgreSQL 日志中写入的时间戳所用的时区。
log_timezone 在 PostgreSQL 8.3 中添加。
用法
服务器日志中显示的时区是对应时区的缩写,例如对于 Europe/Berlin,将显示 CEST。有关时区到缩写的映射列表,请参阅 pg_timezone_names。但是,不能直接指定时区缩写。
默认值
log_timezone 的默认值为:GMT。
请注意,在 initdb 生成的 postgresql.conf 文件中,log_timezone 的值会明确设置为反映本地服务器时区。
按 PostgreSQL 版本详细信息
log_timezone (PostgreSQL 19)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/19/postgresql.conf |
| 源行 | 641 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 18)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/18/postgresql.conf |
| 源行 | 641 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 17)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/17/postgresql.conf |
| 源行 | 622 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 16)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/16/postgresql.conf |
| 源行 | 603 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 15)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/15/postgresql.conf |
| 源行 | 597 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 14)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/14/postgresql.conf |
| 源行 | 580 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 13)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/13/postgresql.conf |
| 源行 | 564 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 12)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/12/postgresql.conf |
| 源行 | 540 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 11)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/11/postgresql.conf |
| 源行 | 481 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 10)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/10/postgresql.conf |
| 源行 | 472 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 9.6)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/96/postgresql.conf |
| 源行 | 449 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 9.5)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/95/postgresql.conf |
| 源行 | 432 |
| 需要重启 | false |
文档:log_timezone
log_timezone (PostgreSQL 9.4)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/94/postgresql.conf |
| 源行 | 436 |
文档:log_timezone
log_timezone (PostgreSQL 9.3)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/93/postgresql.conf |
| 源行 | 418 |
文档:log_timezone
log_timezone (PostgreSQL 9.2)
| 设置 | GMT |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 配置文件 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | GMT |
| 重置值 | GMT |
| 源文件 | /home/barwick/devel/postgres/data/92/postgresql.conf |
| 源行 | 418 |
文档:log_timezone
log_timezone (PostgreSQL 9.1)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 环境变量 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 |
文档:log_timezone
log_timezone (PostgreSQL 9.0)
| 设置 | 未知 |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 命令行 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | 未知 |
| 重置值 | 未知 |
| 源文件 | |
| 源行 |
文档:log_timezone
log_timezone (PostgreSQL 8.4)
| 设置 | 未知 |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 命令行 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | 未知 |
| 重置值 | 未知 |
| 源文件 | |
| 源行 |
文档:log_timezone
log_timezone (PostgreSQL 8.3)
| 设置 | |
| 单位 | |
| 类别 | 报告和日志记录 / 记录什么 |
| 简短描述 | 设置在日志消息中使用的时间区。 |
| 扩展描述 | |
| 上下文 | sighup |
| 变量类型 | string |
| 来源 | 命令行 |
| 最小值 | |
| 最大值 |
文档:log_timezone
变更历史
- PostgreSQL 8.3
- 添加(提交 bdd6b622)
示例
log_timezone 通常由 initdb 设置为服务器时区。
$ initdb -D /var/lib/pgsql/data ... selecting default time zone ... Europe/Berlin ... $ grep log_timezone /var/lib/pgsql/data/postgresql.conf log_timezone = 'Europe/Berlin'
将 log_timezone 设置为 Europe/Berlin 的示例日志输出
[2022-08-15 03:05:32 CEST] psql postgres postgres LOG: 00000: statement: SELECT 1;
无法为 log_timezone 指定时区缩写。
postgres=# ALTER SYSTEM SET log_timezone = 'CEST'; ERROR: invalid value for parameter "log_timezone": "CEST"
参考资料
- PostgreSQL 文档: log_timezone
