config_file 是一个 配置参数，用于指定主 postgresql.conf 文件的位置。
config_file 添加于 PostgreSQL 8.1。
默认值
config_file 的默认值为：data_directory。
用法
config_file 只能作为 postgres 命令行上的选项提供，以指定它应该从中读取其配置的位置。数据库实例启动后，它只能用于显示主 postgresql.conf 文件的位置。
请注意，这只会显示主配置文件的位置，该文件可能通过各种 包含机制包含一个或多个其他配置文件。要查找特定配置项的来源，请参考 pg_settings 视图（该视图也可用于确定从主配置文件包含的所有配置文件的位置）。
如果未指定 config_file，PostgreSQL 将期望在 data_directory 中找到 postgresql.conf。
按 PostgreSQL 版本详细说明
config_file (PostgreSQL 17)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | 否 |
文档: config_file
config_file (PostgreSQL 16)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | 否 |
文档: config_file
config_file (PostgreSQL 15)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | 否 |
文档: config_file
config_file (PostgreSQL 14)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | 否 |
文档: config_file
config_file (PostgreSQL 13)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | 否 |
文档: config_file
config_file (PostgreSQL 12)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | 否 |
文档: config_file
config_file (PostgreSQL 11)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | 否 |
文档: config_file
config_file (PostgreSQL 10)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | 否 |
文档: config_file
config_file (PostgreSQL 9.6)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | 否 |
文档: config_file
config_file (PostgreSQL 9.5)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 | |
| 待处理重启 | 否 |
文档: config_file
config_file (PostgreSQL 9.4)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: config_file
config_file (PostgreSQL 9.3)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: config_file
config_file (PostgreSQL 9.2)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: config_file
config_file (PostgreSQL 9.1)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: config_file
config_file (PostgreSQL 9.0)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: config_file
config_file (PostgreSQL 8.4)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | |
| 重置值 | |
| 源文件 | |
| 源代码行 |
文档: config_file
config_file (PostgreSQL 8.3)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 |
文档: config_file
config_file (PostgreSQL 8.2)
| 设置 | |
| 单位 | |
| 类别 | 文件位置 |
| 简短描述 | 设置服务器的主配置文件。 |
| 额外描述 | |
| 上下文 | postmaster |
| 变量类型 | 字符串 |
| 来源 | 覆盖 |
| 最小值 | |
| 最大值 |
文档: 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