config_file 是一个 配置参数,用于指定主 postgresql.conf 文件的位置。
config_file 在 PostgreSQL 8.1 中添加。
默认值
config_file 的默认值为:data_directory。
用法
config_file 只能作为 postgres 命令行选项来提供,以指定它应该从哪里读取配置。一旦数据库实例启动,它只能用来显示主 postgresql.conf 文件的位置。
请注意,这只会显示主配置文件(main configuration file)的位置,主配置文件可能通过各种 include 机制包含一个或多个其他配置文件。要查找特定配置项的来源,请参考 pg_settings 视图(它还可以用于确定从主配置文件中包含的所有配置文件的位置)。
如果未指定 config_file,PostgreSQL 将期望在 data_directory 中找到 postgresql.conf。
按 PostgreSQL 版本详细信息
config_file (PostgreSQL 19)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 18)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 17)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 16)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 15)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 14)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 13)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 12)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 11)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 10)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 9.6)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 9.5)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 | |
| 需要重启 | false |
文档:config_file
config_file (PostgreSQL 9.4)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 |
文档:config_file
config_file (PostgreSQL 9.3)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 |
文档:config_file
config_file (PostgreSQL 9.2)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 |
文档:config_file
config_file (PostgreSQL 9.1)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 |
文档:config_file
config_file (PostgreSQL 9.0)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 |
文档:config_file
config_file (PostgreSQL 8.4)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 启动值 | |
| 重置值 | |
| 源文件 | |
| 源行 |
文档:config_file
config_file (PostgreSQL 8.3)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 |
文档:config_file
config_file (PostgreSQL 8.2)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 扩展描述 | |
| 上下文 | postmaster |
| 变量类型 | string |
| 来源 | override |
| 最小值 | |
| 最大值 |
文档:config_file
变更历史
- PostgreSQL 8.1
- 添加于 (提交 337ffcdd)
示例
显示当前配置文件位置
postgres=# SHOW config_file;
config_file
-------------------------------------
/var/lib/pgsql/data/postgresql.conf
(1 row)
config_file 无法修改
postgres=# ALTER SYSTEM SET config_file = '/var/lib/pgsql/data/postgresql-new.conf'; ERROR: parameter "config_file" cannot be changed
通过 pg_ctl 传递自定义配置文件位置
$ pg_ctl -D /tmp/testdb -o '-c config_file=/tmp/testdb-conf/postgresql.conf -p6432' -l /tmp/testdb.log start
waiting for server to start.... done
server started
$ psql -p 6432 -c 'SHOW config_file'
config_file
----------------------------------
/tmp/testdb-conf/postgresql.conf
(1 row)
参考资料
- PostgreSQL 文档: config_file
