include_dir
是一个 配置文件 指令,用于指定包含配置文件的目录。
include_dir
在 PostgreSQL 9.3 中添加。
用法
该目录可以指定为完整路径,也可以相对于包含 include_dir
的配置文件所在的目录。该目录必须存在,并且PostgreSQL运行的用户能够读取。配置文件可以包含多个 include_dir
指令。
目录内容将按以下方式处理:
- 所有以
.conf
结尾的文件都将按文件名顺序读取- 文件名顺序由 C 语言区域设置定义
- 以句点开头的文件将不会被读取
- 任何读取的文件本身都可以包含
include_dir
指令 - 指定的
include_dir
目录不需要包含任何配置文件
更改历史记录
- PostgreSQL 9.3
- 添加(提交 2a0c81a1)
示例
include_dir
的基本用法示例
include_dir = 'conf.d' # include files ending in '.conf' from # a directory, e.g., 'conf.d'
如果尝试通过重新加载配置来指定一个不存在的目录,日志将包含类似于以下内容的条目:
[2022-07-06 09:05:47 UTC] LOG: 58P01: could not open configuration directory "/var/lib/pgsql/data/conf.d": No such file or directory [2022-07-06 09:05:47 UTC] F0000: configuration file "/var/lib/pgsql/datapostgresql.conf" contains errors; no changes were applied
如果在 include_dir
包含无效目录时启动或重新启动 PostgreSQL,启动将失败,并显示类似于以下内容的日志消息:
waiting for server to start....2022-07-06 09:14:38.689 GMT [18854] LOG: could not open configuration directory "/var/lib/pgsql/data/conf.d": No such file or directory 2022-07-06 09:14:38.689 GMT [18854] FATAL: configuration file "/var/lib/pgsql/data/postgresql.conf" contains errors stopped waiting pg_ctl: could not start server Examine the log output.
参考文献
- PostgreSQL 文档: 管理配置文件内容