1.10. 环境变量 #
下面的环境变量可用于选择默认的连接参数值;当调用代码没有直接指定值时,PQconnectdb、PQsetdbLogin 和
PQsetdb 将使用这些值。它们有助于避免把数据库连接信息硬编码进简单的客户端应用。
PGHOST设置默认的服务器名。如果以斜杠开头,则表示使用 Unix 域通信而非 TCP/IP 通信;该值是存放套接字文件的目录名(默认/tmp)。PGPASSWORD设置当后端要求密码认证时使用的密码。出于安全原因,此功能已被弃用;请考虑改用$HOME/.pgpass文件。PGREALM设置与 PostgreSQL 一起使用的 Kerberos realm(当它与本地 realm 不同时)。如果设置了PGREALM,PostgreSQL 应用将尝试对该 realm 中的服务器进行认证,并使用单独的 ticket 文件以避免与本地 ticket 文件冲突。仅当后端选择了 Kerberos 认证时才会使用此环境变量。PGOPTIONS设置 PostgreSQL 后端的附加运行时选项。PGTTY设置显示来自后端服务器的调试消息的文件或 tty。PGREQUIRESSL设置是否必须通过 SSL 建立连接。若设为 “1”,当服务器不接受 SSL 连接时,libpq 将拒绝连接。仅当 PostgreSQL 编译时包含 SSL 支持时此选项才可用。PGCONNECT_TIMEOUT设置 libpq 尝试连接 PostgreSQL 服务器时等待的最大秒数。此选项至少应设为 2 秒。
下面的环境变量可用于为每个 PostgreSQL 会话指定用户级的默认行为:
PGDATESTYLE设置日期/时间表示的默认风格。PGTZ设置默认时区。PGCLIENTENCODING设置默认的客户端编码(如果配置 PostgreSQL 时选择了多字节支持)。
下面的环境变量可用于为每个 PostgreSQL 会话指定默认的内部行为:
PGGEQO设置遗传优化器的默认模式。
关于这些环境变量的正确取值,请参阅
SET SQL 命令。