PostgreSQL 13.1 中文入门教程 PostgreSQL 环境变量

2024-02-25 开发教程 PostgreSQL 13.1 中文入门教程 匿名 2

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

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

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

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

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

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

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

  • PGPASSFILE的行为和passfile连接参数相同。

  • PGCHANNELBINDING的行为和 channel_binding 连接参数相同.

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

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

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

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

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

  • PGREQUIRESSL的行为和requiressl连接参数相同。为了支持PGSSLMODE变量,这个环境变量已被废弃。同时设置两个变量会抑制这一个的效果。

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

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

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

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

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

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

  • PGSSLMINPROTOCOLVERSION的行为和 ssl_min_protocol_version 连接参数相同。

  • PGSSLMAXPROTOCOLVERSION行为和 ssl_min_protocol_version 连接参数相同。

  • PGGSSENCMODE的行为和 gssencmode连接参数相同。

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

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

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

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

  • PGTARGETSESSIONATTRS的行为和target_session_attrs连接参数相同。

下面的环境变量可用来为每一个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文件的目录。