33.14. 環境變數

版本：11

以下環境變數可用於選擇預設連線參數值，如果呼叫變數沒有直接指定值， 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 設定包含用於訊息本地化的區域設定檔案的目錄。