文字

31.13. 环境变量

下面的环境变量可以用于选择缺省的连接参数值，这些值将被PQconnectdb或 PQsetdbLogin和PQsetdb使用 — 如果调用代码没有直接声明相应值的话。比如，这些（环境变量）可以避免把麻烦的数据库名强加入简单的应用程序的硬代码里面。

PGHOST与host连接参数表现行为相同。
PGHOSTADDR与hostaddr连接参数表现行为相同这样可以代替或除了PGHOST以避免DNS查找的开销。
PGPORT与port连接参数表现行为相同。
PGDATABASE与dbname连接参数表现行为相同。
PGUSER与user连接参数表现行为相同。
PGPASSWORD与password连接参数表现行为相同。使用这个环境变量出于安全原因是不推荐的，因为某些操作系统允许非root用户看到进程的环境变量，通过的PS，而是考虑使用 ~/.pgpass的文件（详情请看Section 31.14）。
PGPASSFILE指定密码文件的名称使用查找。如果没有设置，默认为~/.pgpass （见Section 31.14）。
PGSERVICE与service连接参数表现行为相同。
PGSERVICEFILE指定连接服务的文件中每个用户的名字，如果没有设置默认~/.pg_service.conf (见Section 31.15)。
PGREALM设置与PostgreSQL一起使用的 Kerberos 领地 — 如果该领地与本地领地不同的话。如果设置了PGREALM，libpq应用将试图用这个域（realm）与服务器进行认证并且使用独立的门票文件（ticket files）以避免与本地的门票文件冲突。只有在服务器选择了 Kerberos 认证时才使用这个环境变量。
PGOPTIONS与options连接参数表现行为相同。
PGAPPNAME与application_name连接参数表现行为相同。
PGSSLMODE与sslmode连接参数表现行为相同。
PGREQUIRESSL与requiressl连接参数表现行为相同。
PGSSLCERT与sslcert连接参数表现行为相同。
PGSSLKEY与sslkey连接参数表现行为相同。
PGSSLROOTCERT与sslrootcert连接参数表现行为相同。
PGSSLCRL与sslcrl连接参数表现行为相同。
PGKRBSRVNAME与krbsrvname连接参数表现行为相同。
PGGSSLIB与gsslib连接参数表现行为相同。
PGCONNECT_TIMEOUT与connect_timeout连接参数表现行为相同。

下面的环境变量可以用于为每个PostgreSQL会话声明缺省特性（又见ALTER USER和ALTER DATABASE命令获取基于用户和数据库设置缺省行为的方法。）

PGDATESTYLE设置缺省的日期/时间表现形式。（等效于SET datestyle TO ...）
PGTZ设置缺省的时区。（等效于SET timezone TO ...）
PGCLIENTENCODING设置缺省的客户端编码。（等效于SET client_encoding TO ...）
PGGEQO为基因优化器设置缺省模式。（等效于SET geqo TO ...）

请参考SQL命令SET获取这些环境变量的正确数值。

下面的环境变量决定libpq的内部行为；它们覆盖编译的缺省。

PGSYSCONFDIR设置包含pg_service.conf文件的目录。并在未来的版本其他可能系统范围的配置文件。
PGLOCALEDIR设置包含信息国际化的locale文件目录。