↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1 / 7.0 / 6.5 / 6.4
历史版本PostgreSQL 7.3 已于 2007 年 11 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

1.10. 环境变量 #

下面的环境变量可用于选择默认的连接参数值;当调用代码没有直接指定值时, PQconnectdb、PQsetdbLogin 和 PQsetdb 将使用这些值。它们有助于避免把数据库连接信息硬编码进简单的客户端应用。

  • PGHOST 设置默认的服务器名。如果以斜杠开头,则表示使用 Unix 域通信而非 TCP/IP 通信;该值是存放套接字文件的目录名(默认 /tmp)。

  • PGPORT 设置与 PostgreSQL 后端通信所用的默认 TCP 端口号或 Unix 域套接字文件扩展名。

  • PGDATABASE 设置默认的 PostgreSQL 数据库名。

  • PGUSER 设置连接数据库和认证所用的用户名。

  • 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 命令。

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。