34.15. 环境变量#
以下环境变量可用于选择默认连接参数值,如果调用代码未直接指定值,PQconnectdb、PQsetdbLogin和PQsetdb将使用这些值。例如,这些变量可用于避免将数据库连接信息硬编码到简单的客户端应用程序中。
PGHOST的行为与 host 连接参数相同。PGHOSTADDR的行为与 hostaddr 连接参数相同。可以设置此变量来替代或补充PGHOST,以避免 DNS 查找开销。PGPORT的行为与 port 连接参数相同。PGDATABASE的行为与 dbname 连接参数相同。PGUSER的行为与 user 连接参数相同。PGPASSWORD的行为与 password 连接参数相同。出于安全原因,不建议使用此环境变量,因为某些操作系统允许非 root 用户通过 ps 查看进程环境变量;相反,考虑使用密码文件(请参阅 第 34.16 节)。PGPASSFILE的行为与 passfile 连接参数相同。PGREQUIREAUTH的行为与 require_auth 连接参数相同。PGCHANNELBINDING的行为与 channel_binding 连接参数相同。PGSERVICE的行为与 service 连接参数相同。PGSERVICEFILE指定每个用户连接服务文件(请参阅 第 34.17 节)的名称。默认为~/.pg_service.conf,或 Microsoft Windows 上的%APPDATA%\postgresql\.pg_service.conf。PGOPTIONS的行为与 options 连接参数相同。PGAPPNAME的行为与 application_name 连接参数相同。PGSSLMODE的行为与 sslmode 连接参数相同。PGREQUIRESSL的行为与 requiressl 连接参数相同。此环境变量已弃用,建议使用PGSSLMODE变量;同时设置这两个变量会抑制此变量的效果。PGSSLCOMPRESSION的行为与 sslcompression 连接参数相同。PGSSLCERT的行为与 sslcert 连接参数相同。PGSSLKEY的行为与 sslkey 连接参数相同。PGSSLCERTMODE的行为与 sslcertmode 连接参数相同。PGSSLROOTCERT的行为与 sslrootcert 连接参数相同。PGSSLCRL的行为与 sslcrl 连接参数相同。PGSSLCRLDIR的行为与 sslcrldir 连接参数相同。PGSSLSNI的行为与 sslsni 连接参数相同。PGREQUIREPEER的行为与 requirepeer 连接参数相同。PGSSLMINPROTOCOLVERSION的行为与 ssl_min_protocol_version 连接参数相同。PGSSLMAXPROTOCOLVERSION的行为与 ssl_max_protocol_version 连接参数相同。PGGSSENCMODE的行为与 gssencmode 连接参数相同。PGKRBSRVNAME与 krbsrvname 连接参数的行为相同。PGGSSLIB与 gsslib 连接参数的行为相同。PGGSSDELEGATION与 gssdelegation 连接参数的行为相同。PGCONNECT_TIMEOUT与 connect_timeout 连接参数的行为相同。PGCLIENTENCODING与 client_encoding 连接参数的行为相同。PGTARGETSESSIONATTRS与 target_session_attrs 连接参数的行为相同。PGLOADBALANCEHOSTS与 load_balance_hosts 连接参数的行为相同。
以下环境变量可用于为每个PostgreSQL会话指定默认行为。(另请参见ALTER ROLE和ALTER DATABASE命令,了解如何按用户或按数据库设置默认行为。)
有关这些环境变量的正确值的信息,请参阅SQL命令SET。
以下环境变量决定了libpq的内部行为;它们会覆盖编译时默认值。
