支援的版本:目前 (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 檔案的目錄。

提交更正

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