支援的版本:目前版本 (17) / 16 / 15 / 14 / 13
開發版本:devel
不支援的版本: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

32.15. 環境變數 #

下列環境變數可用於選擇預設的連線參數值,這些值將被 PQconnectdbPQsetdbLoginPQsetdb 使用,如果呼叫程式碼沒有直接指定值。例如,這對於避免將資料庫連線資訊硬編碼到簡單的客戶端應用程式中很有用。

  • PGHOST 的行為與 host 連線參數相同。

  • PGSSLNEGOTIATION 的行為與 sslnegotiation 連線參數相同。

  • PGHOSTADDR 的行為與 hostaddr 連線參數相同。 可以設定此參數來代替或附加到 PGHOST 以避免 DNS 查詢的額外負擔。

  • PGPORT 的行為與 port 連線參數相同。

  • PGDATABASE 的行為與 dbname 連線參數相同。

  • PGUSER 的行為與 user 連線參數相同。

  • PGPASSWORD 的行為與 password 連線參數相同。 由於某些作業系統允許非 root 使用者通過 ps 查看程序環境變數,因此不建議使用此環境變數,出於安全考量,請考慮使用密碼檔案(請參閱第 32.16 節)。

  • PGPASSFILE 的行為與 passfile 連線參數相同。

  • PGREQUIREAUTH 的行為與 require_auth 連線參數相同。

  • PGCHANNELBINDING 的行為與 channel_binding 連線參數相同。

  • PGSERVICE 的行為與 service 連線參數相同。

  • PGSERVICEFILE 指定每個使用者的連線服務檔名(請參閱第 32.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 ROLEALTER DATABASE 命令,以了解如何針對每個使用者或每個資料庫設定預設行為。)

  • PGDATESTYLE 設定日期/時間表示法的預設樣式。(相當於 SET datestyle TO ...。)

  • PGTZ 設定預設時區。(相當於 SET timezone TO ...。)

  • PGGEQO 設定基因查詢最佳化器的預設模式。(相當於 SET geqo TO ...。)

請參閱SQL指令 SET 以取得這些環境變數的正確值的相關資訊。

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

  • PGSYSCONFDIR 設定包含 pg_service.conf 檔案的目錄,並且在未來的版本中可能包含其他系統範圍的組態檔案。

  • PGLOCALEDIR 設定包含訊息本地化 locale 檔案的目錄。

提交更正

如果您在文件中發現任何不正確、與您特定功能的經驗不符或需要進一步澄清的地方,請使用此表單來報告文件問題。