Postgresql 中文操作指南

34.17. The Connection Service File #

连接服务文件允许将 libpq 连接参数与一个服务名称相关联。然后，可以在 libpq 连接字符串中指定服务名称，并将使用关联的设置。这样可以在不需要重新编译使用 libpq 的应用程序的情况下修改连接参数。还可以使用 PGSERVICE 环境变量指定服务名称。

可以在每个用户服务文件或系统范围文件内定义服务名称。如果相同的服务名称同时存在于用户文件和系统文件中，则用户文件具有优先权。默认情况下，每个用户服务文件被命名为 ~/.pg_service.conf。在 Microsoft Windows 上，它被命名为 %APPDATA%\postgresql\.pg_service.conf（其中 %APPDATA% 是指用户配置文件中的 Application Data 子目录）。可以通过设置环境变量 PGSERVICEFILE 指定不同的文件名称。系统范围文件被命名为 pg_service.conf。默认情况下，它在 PostgreSQL 安装的 etc 目录中进行查找（使用 pg_config --sysconfdir 准确识别此目录）。可以通过设置环境变量 PGSYSCONFDIR 指定另一个目录，但不能指定不同的文件名称。

两个服务文件都使用“INI 文件”格式，其中部分名称是服务名称，参数是连接参数；有关列表，请参阅 Section 34.1.2。例如：

# comment
[mydb]
host=somehost
port=5433
user=admin

在 share/pg_service.conf.sample 的 PostgreSQL 安装中提供了示例文件。

从服务文件获取的连接参数与从其他来源获取的参数相结合。服务文件设置将覆盖相应的环境变量，并且反过来还可以通过在连接字符串中直接给出的值将其覆盖。例如，使用上述服务文件，连接字符串 service=mydb port=5434 将使用由环境变量或内置默认值设置的主机 somehost、端口 5434、用户 admin 和其他参数。