Переменные среды

Следующие переменные среды можно использовать для выбора значений параметров подключения по умолчанию, которые будут применяться функциями PQconnectdb, PQsetdbLogin и PQsetdb, если вызывающий код не задает напрямую никакое значение. С их помощью можно, например, обойтись без предварительного задания информации о подключении к базе данных в простых клиентских приложениях.

• PGHOST ведет себя так же, как параметр подключения host.

• PGHOSTADDR ведет себя так же, как параметр подключения hostaddr. Эту переменную можно установить вместо или в дополнение к PGHOST для предотвращения затрат на просмотр DNS.

• PGPORT ведет себя так же, как параметр подключения port.

• PGDATABASE ведет себя так же, как параметр подключения dbname.

• PGUSER ведет себя так же, как параметр подключения user.

• PGPASSWORD ведет себя так же, как параметр подключения password. Использовать эту переменную среды не рекомендуется по соображениям безопасности, поскольку некоторые операционные системы позволяют пользователям, отличным от root, видеть переменные среды процессов через ps; вместо этого попробуйте воспользоваться файлом паролей (см. раздел [Файл паролей]).

• PGPASSFILE ведет себя так же, как параметр подключения passfile.

• PGCHANNELBINDING ведет себя так же, как параметр подключения channel_binding.

• PGSERVICE ведет себя так же, как параметр подключения service.

• PGSERVICEFILE задает имя файла подключений служб для отдельного пользователя (см. раздел [Файл подключений служб]). По умолчанию используется имя ~/.pg_service.conf.

• PGOPTIONS ведет себя так же, как параметр подключения options.

• PGAPPNAME ведет себя так же, как параметр подключения application_name.

• PGSSLMODE ведет себя так же, как параметр подключения sslmode.

• PGREQUIRESSL ведет себя так же, как параметр подключения requiressl. Эта переменная среды выводится из употребления, и ее заменяет переменная PGSSLMODE; установка обеих переменных подавляет эффект значения данной.

• PGSSLCOMPRESSION ведет себя так же, как параметр подключения sslcompression.

• PGSSLCERT ведет себя так же, как параметр подключения sslcert.

• PGSSLKEY ведет себя так же, как параметр подключения sslkey.

• PGSSLROOTCERT ведет себя так же, как параметр подключения sslrootcert.

• PGSSLCRL ведет себя так же, как параметр подключения sslcrl.

• PGSSLCRLDIR ведет себя так же, как параметр подключения sslcrldir.

• PGSSLSNI ведет себя так же, как параметр подключения sslsni.

• PGREQUIREPEER ведет себя так же, как параметр подключения requirepeer.

• PGSSLMINPROTOCOLVERSION ведет себя так же, как параметр подключения ssl_min_protocol_version.

• PGSSLMAXPROTOCOLVERSION ведет себя так же, как параметр подключения ssl_max_protocol_version.

• PGGSSENCMODE ведет себя так же, как параметр подключения gssencmode.

• PGKRBSRVNAME ведет себя так же, как параметр подключения krbsrvname.

• PGCONNECT_TIMEOUT ведет себя так же, как параметр подключения connect_timeout.

• PGCLIENTENCODING ведет себя так же, как параметр подключения client_encoding.

• PGTARGETSESSIONATTRS ведет себя так же, как параметр подключения target_session_attrs.

Следующие переменные среды можно использовать, чтобы задать поведение по умолчанию для каждого сеанса QHB. (См. также справочные страницы команд ALTER ROLE и ALTER DATABASE, где описаны способы установить поведение по умолчанию для отдельного пользователя или отдельной базы данных.)

• PGDATESTYLE устанавливает стиль представления даты/времени по умолчанию. (Равнозначно SET datestyle TO ....)

• PGTZ устанавливает часовой пояс по умолчанию. (Равнозначно SET timezone TO ....)

• PGGEQO устанавливает режим по умолчанию для генетического оптимизатора запросов. (Равнозначно SET geqo TO ....)

Информацию о корректных значениях для этих переменных среды см. на справочной странице команды SET.

Следующие переменные среды определяют внутреннее поведение libpq; они переопределяют встроенные значения по умолчанию.

• PGSYSCONFDIR устанавливает каталог, содержащий файл qhb_service.conf, а в будущих версиях, возможно, и другие общесистемные файлы конфигурации.

• PGLOCALEDIR устанавливает каталог, содержащий файлы locale, предназначенные для локализации сообщений.