pgbouncer

Contents

Синтаксис
Описание
Параметры

Управляет пулами подключений к базе данных.

pgbouncer [OPTION ...] <pgbouncer.ini>

  OPTION
   [ -d | --daemon ]
   [ -R | --reboot ]
   [ -q | --quiet ]
   [ -v | --verbose ]
   [ {-u | --user}=<username> ]

pgbouncer [ -V | --version ] | [ -h | --help ]

Описание

PgBouncer — легковесный менеджер пулов подключений для Greengage DB и PostgreSQL. Для каждой комбинации пользователя и базы данных поддерживается отдельный пул подключений. При обращении клиента PgBouncer либо создает новое подключение, либо использует существующее подключение из пула. При отключении клиента подключение возвращается в пул.

PgBouncer поддерживает стандартный интерфейс подключения PostgreSQL и Greengage DB. Клиентские приложения (например, psql) должны подключаться к хосту и порту PgBouncer, а не напрямую к мастер-хосту Greengage DB.

Настройка PgBouncer и доступа к Greengage DB выполняется через файл конфигурации. Имя файла (обычно pgbouncer.ini) указывается при запуске команды pgbouncer. Файл содержит информацию о расположении баз данных Greengage DB. В pgbouncer.ini также задаются параметры процесса, пула подключений, авторизованных пользователей и аутентификации.

По умолчанию pgbouncer запускается в интерактивном режиме (не в фоне). Для запуска в фоновом режиме (как демон) используйте параметр -d.

Процесс pgbouncer запускается от имени пользователя операционной системы. При необходимости можно указать другого пользователя для запуска pgbouncer.

PgBouncer включает консоль администрирования, аналогичную psql. Авторизованные пользователи могут подключаться к виртуальной базе данных для мониторинга и управления PgBouncer. Через консоль администрирования можно управлять демоном PgBouncer. Консоль также позволяет обновлять и перезагружать конфигурацию во время работы без перезапуска процесса.

Дополнительную информацию о PgBouncer см. в PgBouncer FAQ.

-d | --daemon: Запускает PgBouncer как демон (в фоновом режиме). По умолчанию запускается в интерактивном режиме (не в фоне).

В режиме демона необходимо задать pidfile, а также logfile или syslog. После перехода в фоновый режим логи не записываются в stderr.

Для остановки демона выполните команду SHUTDOWN из консоли администрирования.
-R | --reboot: Перезапускает PgBouncer с указанными аргументами командной строки. При этом выполняется подключение к работающему процессу, открытые сокеты передаются новому процессу. Если активный процесс отсутствует, выполняется обычный запуск. При перезапуске подключения без TLS сохраняются, а TLS-подключения разрываются.

Для перезапуска демона используйте параметры -Rd.

ПРИМЕЧАНИЕ

Перезапуск доступен только при поддержке сокетов домена Unix операционной системой и если параметр unix_socket_dir не отключен.
-q | --quiet: Запускает PgBouncer в тихом режиме без вывода сообщений в stderr. Не влияет на уровень детализации логов — отключается только стандартный вывод ошибок. Применяется в скриптах init.d.
-v | --verbose: Увеличивает детализацию выводимых сообщений. Можно указывать несколько раз для постепенного увеличения уровня детализации.
{-u | --user}=<username>: Запускает процесс от имени пользователя username.
-V | --version: Выводит версию PgBouncer и завершает работу.
-h | --help: Выводит справку и завершает работу.

pg_restore

plcontainer

pgbouncer

Синтаксис

Описание

Параметры