description: 版本：11

33.14. 環境變數

以下環境變數可用於選擇預設連線參數值，如果呼叫變數沒有直接指定值， PQconnectdb，PQsetdbLogin 和 PQsetdb 將使用這些值。例如，這些有助於避免將資料庫連線訊息硬寫到簡單的用戶端應用程序中。

  • PGHOST 的行為與 host 參數相同。
  • PGHOSTADDR 的行為與 hostaddr 連線參數相同。這可以代替 PGHOST 或者除了 PGHOST 之外設定，以避免 DNS 查詢的開銷。
  • PGPORT 的行為與 port 連線參數相同。
  • PGDATABASE 的行為與 dbname 連線參數相同。
  • PGUSER 的行為與 user 連線參數相同。
  • PGPASSWORD 的行為與 password 連線參數相同。但由於安全因素，不建議使用此環境變數，因為某些作業系統允許非 root 使用者透過 ps 查看程序環境變數；而是考慮使用密碼檔案（參閱第 33.15 節）。
  • PGPASSFILE 行為與 passfile 連線參數相同。
  • PGSERVICE behaves the same as the service connection parameter.
  • PGSERVICEFILE specifies the name of the per-user connection service file. If not set, it defaults to ~/.pg_service.conf (see Section 33.16).
  • PGOPTIONS behaves the same as the options connection parameter.
  • PGAPPNAME behaves the same as the application_name connection parameter.
  • PGSSLMODE behaves the same as the sslmode connection parameter.
  • PGREQUIRESSL behaves the same as the requiressl connection parameter. This environment variable is deprecated in favor of the PGSSLMODE variable; setting both variables suppresses the effect of this one.
  • PGSSLCOMPRESSION behaves the same as the sslcompression connection parameter.
  • PGSSLCERT behaves the same as the sslcert connection parameter.
  • PGSSLKEY behaves the same as the sslkey connection parameter.
  • PGSSLROOTCERT behaves the same as the sslrootcert connection parameter.
  • PGSSLCRL behaves the same as the sslcrl connection parameter.
  • PGREQUIREPEER behaves the same as the requirepeer connection parameter.
  • PGKRBSRVNAME behaves the same as the krbsrvname connection parameter.
  • PGGSSLIB behaves the same as the gsslib connection parameter.
  • PGCONNECT_TIMEOUT behaves the same as the connect_timeout connection parameter.
  • PGCLIENTENCODING behaves the same as the client_encoding connection parameter.
  • PGTARGETSESSIONATTRS behaves the same as the target_session_attrs connection parameter.

以下環境變數可用於指定每個 PostgreSQL 連線的預設行為。（有關基於每個使用者或每個資料庫設定預設行為的方法，另請參閱 ALTER ROLE 和 ALTER DATABASE 指令。）

  • PGDATESTYLE 設定日期/時間表示的預設樣式。 （相當於 SET datestyle TO ….）
  • PGTZ設定預設時區。 （相當於 SET timezone TO ....）
  • PGGEQO 設定 genetic 查詢最佳化程序的預設模式。（相當於 SET geqo TO ....）

有關這些環境變數的正確值的資訊，請參閱 SQL 指令 SET。

以下環境變數決定了 libpq 的內部行為；它們會覆寫編譯時的預設值。

  • PGSYSCONFDIR 設定包含 pg_service.conf 檔案的目錄，在未來版本中可能用於設定其他系統範圍的組態檔案。
  • PGLOCALEDIR 設定包含用於訊息本地化的區域設定檔案的目錄。