一些变量

下列环境变量能被用于选择默认的连接参数值,如果调用代码没有直接指定值,它们将被用于PQconnectdb、PQsetdbLogin和PQsetdb。例如,这些有助于防止数据库连接信息被硬编码到简单的客户端应用中。

PGHOST的行为和host连接参数相同。


PGHOSTADDR的行为和hostaddr连接参数相同。可以设置它来替代或者作为PGHOST的补充来防止 DNS 查找负担。


PGPORT的行为和port连接参数相同。


PGDATABASE的行为和dbname连接参数相同。


PGUSER的行为和user连接参数相同。


PGPASSWORD的行为和password连接参数相同。出于安全原因,我们不推荐使用这个环境变量,因为某些操作系统允许非根用户通过ps看到进程的环境变量。可以考虑使用~/.pgpass文件(见第 32.15 节)。


PGPASSFILE指定要用于查找的口令文件的名称。如果没有设置,默认为~/.pgpass(见第 32.15 节)。


PGSERVICE的行为和service连接参数相同。


PGSERVICEFILE指定针对每个用户的连接服务文件名。如果没有设置,默认为~/.pg_service.conf(见第 32.16 节)。


如果PostgreSQL要使用的 Kerberos 领域和本地领域不同,PGREALM可以设置它。如果PGREALM被设置,libpq应用将尝试通过服务器鉴定这个领域并且使用独立的票据文件来避免与本地票据文件冲突。只有在服务器选择了 GSSAPI 认证时,这个环境变量才被使用。


PGOPTIONS的行为和options连接参数相同。


PGAPPNAME的行为和application_name连接参数相同。


PGSSLMODE的行为和sslmode连接参数相同。


PGREQUIRESSL的行为和requiressl连接参数相同。


PGSSLCOMPRESSION的行为和sslcompression连接参数相同。


PGSSLCERT的行为和sslcert连接参数相同。


PGSSLKEY的行为和sslkey连接参数相同。


PGSSLROOTCERT的行为和sslrootcert连接参数相同。


PGSSLCRL的行为和sslcrl连接参数相同。


PGREQUIREPEER的行为和requirepeer连接参数相同。


PGKRBSRVNAME的行为和krbsrvname连接参数相同。


PGGSSLIB的行为和gsslib连接参数相同。


PGCONNECT_TIMEOUT的行为和connect_timeout连接参数相同。


PGCLIENTENCODING的行为和client_encoding连接参数相同。

下面的环境变量可用来为每一个PostgreSQL会话指定默认行为(为每一个用户或每一个数据库设置默认行为的方法还可见ALTER ROLE和ALTER DATABASE命令)。

PGDATESTYLE设置日期/时间表示的默认风格(等同于SET datestyle TO ...)。


PGTZ设置默认的时区(等同于SET timezone TO ...)。


PGGEQO为遗传查询优化器设置默认模式(等同于SET geqo TO ...)。

这些环境变量的正确值可参考SQL 命令 SET。

下面的环境变量决定libpq的内部行为,它们会覆盖编译在程序中的默认值。

PGSYSCONFDIR设置包含pg_service.conf文件以及未来版本中可能出现的其他系统范围配置文件的目录。


PGLOCALEDIR设置包含用于消息本地化的locale文件的目录。

密码文件

一个用户主目录中的.pgpass文件或者被PGPASSFILE引用的文件可能包含在连接需要时使用的口令(并且其他情况不会指定口令)。在微软的 Windows 上该文件被命名为%APPDATA%\postgresql\pgpass.conf(其中%APPDATA%指的是用户配置中的应用数据子目录)。

这个文件应该包含下列格式的行:

hostname:port:database:username:password

(你可以向该文件增加一个提醒:把上面的行复制到该文件并且在前面加上#)。前四个域的每一个都可以是文字值或者匹配任何东西的*。第一个匹配当前连接参数的行中的口令域将被使用(因此,在使用通配符时把更特殊的项放在前面)。如果一个条目需要包含:或者\,用\对该字符转义。一个localhost主机名匹配来自本地机器的 TCP (主机名localhost)和 Unix 域套接字(pghost为空或者默认套接字目录)连接。在一台后备服务器上,一个名为replication的数据库名匹配到主控服务器的流复制连接。database域的用途有限,因为用户对同一个集簇中所有数据库都有相同的口令。

在 Unix 系统上,.pgpass上的权限必须不允许所有人或组内访问,可以用命令 chmod 0600 ~/.pgpass 实现。如果权限没有这么严格,该文件将被忽略。在微软 Windows 上,该文件被假定存储在一个安全的目录中,因此不会进行特别的权限检查。