32.17. Файл службы подключения#
32.17. Файл службы подключения #
Файл службы подключения позволяет ассоциировать параметры подключения libpq с одним именем службы. Затем это имя службы можно указать в строке подключения libpq, и будут использованы соответствующие настройки. Это позволяет изменять параметры подключения без необходимости повторной компиляции приложения, использующего libpq. Имя службы также можно указать с помощью переменной среды PGSERVICE.
Имена сервисов могут быть определены либо в пользовательском файле сервисов, либо в системном файле. Если одно и то же имя сервиса присутствует и в пользовательском, и в системном файле, приоритет имеет пользовательский файл. По умолчанию пользовательский файл сервисов называется ~/.pg_service.conf. Другое имя файла можно указать, установив переменную окружения PGSERVICEFILE. Системный файл называется pg_service.conf. По умолчанию он ищется в каталоге etc установки Tantor SE (используйте pg_config --sysconfdir, чтобы точно определить этот каталог). Другой каталог, но не другое имя файла, можно указать, установив переменную окружения PGSYSCONFDIR.
Или файл службы использует формат “INI-файла”, где имя раздела - это имя службы, а параметры - это параметры подключения; см. Раздел 32.1.2 для списка. Например:
# comment [mydb] host=somehost port=5433 user=admin
Пример файла предоставляется в установке Tantor SE по пути share/pg_service.conf.sample.
Все параметры подключения, полученные из файла службы, объединяются с параметрами, полученными из других источников. Настройка файла службы переопределяет соответствующую переменную среды, и в свою очередь может быть переопределена значением, указанным непосредственно в строке подключения. Например, при использовании вышеуказанного файла службы, строка подключения service=mydb port=5434 будет использовать хост somehost, порт 5434, пользователя admin и другие параметры, установленные переменными среды или встроенными значениями по умолчанию.