pgbouncer - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

pgbouncer - легкий пулер підключень для PostgreSQL

СИНТАКСИС

pgbouncer [-d][-R][-v][-u користувач]
pgbouncer -V|-h

На комп’ютерах Windows доступні такі параметри:

pgbouncer.exe [-v][-u користувач]
pgbouncer.exe -V|-h

Додаткові параметри для налаштування служби Windows:

pgbouncer.exe --regservice
pgbouncer.exe --unregservice

ОПИС

pgbouncer є пулом підключень PostgreSQL. До будь-якої цільової програми можна підключити
pgbouncer ніби це сервер PostgreSQL, і pgbouncer створить підключення до
фактичний сервер, або він повторно використовуватиме одне зі своїх існуючих підключень.

Мета pgbouncer полягає в тому, щоб знизити вплив на продуктивність відкриття нових з’єднань до
PostgreSQL.

Щоб не порушити семантику транзакцій для об’єднання з’єднань, pgbouncer
підтримує кілька типів об'єднання під час обертання з'єднань:

Session об'єднання
Найбільш ввічливий метод. Коли клієнт підключається, буде призначено підключення до сервера
це протягом усього часу, коли клієнт залишається на зв'язку. Коли клієнт відключається,
підключення до сервера буде повернуто в пул. Це метод за замовчуванням.

Угода об'єднання
Підключення до сервера призначається клієнту лише під час транзакції. Коли
PgBouncer помічає, що транзакція закінчена, з’єднання з сервером буде відновлено
в басейн.

Заява об'єднання
Найбільш агресивний метод. Підключення до сервера буде повернуто в пул
відразу після завершення запиту. Трансакції з кількома операторами заборонені
цей режим як би вони зламали.

Інтерфейс адміністрування pgbouncer складається з деяких нових ШОУ доступні команди
при підключенні до спеціальної «віртуальної» бази даних pgbouncer.

ШВИДКИЙ ПОЧАТОК

Основні налаштування та використання наступні.

1. Створіть файл pgbouncer.ini. Деталі в pgbouncer(5). Простий приклад:

[бази даних]
шаблон1 = хост=127.0.0.1 порт=5432 dbname=template1

[pgbouncer]
List_port = 6543
List_addr = 127.0.0.1
auth_type = md5
auth_file = користувачі.txt
файл журналу = pgbouncer.log
pidfile = pgbouncer.pid
admin_users = деякий користувач

2. Створювати users.txt файл, який містить користувачів, яким дозволено:

"someuser" "same_password_as_in_server"

3 Запуск pgbouncer:

$ pgbouncer -d pgbouncer.ini

4. Нехай ваша заявка (або psql клієнт) підключитися до pgbouncer замість безпосередньо до
Сервер PostgreSQL:

$ psql -p 6543 -U шаблон користувача1

5. Керувати pgbouncer шляхом підключення до спеціальної бази адміністрування pgbouncer та
видачі Показувати допомога; починати:

$ psql -p 6543 -U деякий користувач pgbouncer
pgbouncer=# показати довідку;
ПРИМІТКА. Використання консолі
ДЕТАЛІ:
ПОКАЗАТИ [ДОВІДКА|КОНФІГ.|БАЗИ ДАНИХ|FDS|ПУЛИ|КЛІЄНТИ|СЕРВЕРИ|СОКЕТИ|СПИСКИ|ВЕРСІЯ]
Ключ SET = arg
RELOAD
PAUSE
ПРИВЕРНУТИ
РЕЗЮМЕ
ЗУПИНКА

6. Якщо ви внесли зміни до файлу pgbouncer.ini, ви можете перезавантажити його за допомогою:

pgbouncer=# ПЕРЕЗАвантаження;

КОМАНДА ЛІНІЯ Перемикачі

-d Запуск у фоновому режимі. Без цього процес буде виконуватися на передньому плані. Примітка: ні
робота на Windows, pgbouncer потрібно запустити там як службу.

-R Зробіть онлайн-перезавантаження. Це означає підключення до запущеного процесу, завантаження
відкривати з нього розетки, а потім використовувати їх. Якщо активного процесу немає, завантажтеся
нормально. Примітка. Працює лише якщо ОС підтримує сокети Unix та unix_socket_dir is
не вимкнено в конфігурації. Не працює на машинах Windows. Не працює з TLS
з'єднання, вони відкидаються.

-u користувач
Під час запуску перейдіть до даного користувача.

-v Збільште багатослівність. Можна використовувати кілька разів.

-q Мовчіть - не входьте до стандартного виведення. Зауважте, що це не впливає лише на докладність журналу
цей стандартний вихід не можна використовувати. Для використання в сценаріях init.d.

-V Показати версію.

-h Показати коротку довідку.

--regservice
Win32: зареєструйте pgbouncer для запуску як служби Windows. The назва_послуги конфиг
значення параметра використовується як ім'я для реєстрації.

--unregservice
Win32: скасування реєстрації служби Windows.

ADMIN Консоль

Консоль доступна при звичайному підключенні до бази даних pgbouncer:

$ psql -p 6543 pgbouncer

Тільки користувачі, зазначені в параметрах конфігурації admin_users or stats_users дозволяється
увійти в консоль. (Крім випадків, коли auth_mode=будь-який, тоді будь-якому користувачу дозволено входити як a
stats_user.)

Крім того, ім’я користувача pgbouncer дозволяється ввійти без пароля, якщо логін
надходить через сокет Unix, і клієнт має такий же uid користувача Unix, що й запущений процес.

шоу Команди
Команда ШОУ команди виводять інформацію. Кожна команда описана нижче.

ШОУ СТАТИСТИКА;
Показує статистику.

база даних
Статистика представлена ​​для кожної бази даних.

total_requests
Загальна кількість запитів SQL, об’єднаних у пул pgbouncer.

всього_отримано
Загальний обсяг мережевого трафіку, отриманого в байтах pgbouncer.

total_sent
Загальний обсяг мережевого трафіку, надісланого в байтах pgbouncer.

загальний_час_запиту
Загальна кількість мікросекунд, витрачених на pgbouncer при активному підключенні до
PostgreSQL.

avg_req
Середня кількість запитів за секунду за останній період статистики.

avg_recv
Середня кількість отриманих (від клієнтів) байтів за секунду.

avg_sent
Середня кількість надісланих (клієнтам) байтів за секунду.

avg_query
Середня тривалість запиту в мікросекундах.

ШОУ СЕРВЕРИ;
тип S, для сервера.

користувач ім'я користувача pgbouncer використовується для підключення до сервера.

база даних
Ім'я бази даних.

були Стан підключення до сервера pgbouncer, один із активний, використовуваний or холостому ходу.

адр IP-адреса сервера PostgreSQL.

порт Порт сервера PostgreSQL.

локальна_адреса
Початкова адреса підключення на локальній машині.

локальний_порт
Початковий порт підключення на локальній машині.

час_підключення
Коли з’єднання було встановлено.

запит_час
Коли було подано останній запит.

ptr Адреса внутрішнього об'єкта для цього підключення. Використовується як унікальний ідентифікатор.

за посиланням Адреса клієнтського з'єднання, з яким сервер з'єднаний.

віддалений_під
Pid процесу серверного сервера. У випадку, якщо підключення здійснюється через unix-сокет і ОС
підтримує отримання інформації про ідентифікатор процесу, це pid OS. Інакше він витягується з
скасувати відправку сервера пакетів, який має бути PID, якщо сервер є Postgres, але це так
випадкове число на випадок, якщо сервер це інший PgBouncer.

ШОУ КЛІЄНТИ;
тип C, для клієнта.

користувач Користувач, підключений до клієнта.

база даних
Ім'я бази даних.

були Стан клієнтського підключення, один з активний, використовуваний, очікування or холостому ходу.

адр IP-адреса клієнта.

порт Клієнт порту підключений до.

локальна_адреса
Кінцева адреса підключення на локальній машині.

локальний_порт
Кінцевий порт підключення на локальній машині.

час_підключення
Позначка часу підключення.

запит_час
Позначка часу останнього запиту клієнта.

ptr Адреса внутрішнього об'єкта для цього підключення. Використовується як унікальний ідентифікатор.

за посиланням Адреса підключення до сервера, з якою клієнт підключений.

віддалений_під
Ідентифікатор процесу, якщо клієнт підключається через сокет UNIX і ОС підтримує його отримання.

ШОУ БАССЕЙНИ;
Новий запис пулу робиться для кожної пари (база даних, користувач).

база даних
Ім'я бази даних.

користувач Ім'я користувача.

cl_active
Клієнтські з’єднання, які пов’язані із з’єднанням із сервером і можуть обробляти запити.

cl_waiting
Клієнтські з’єднання надіслали запити, але ще не отримали з’єднання з сервером.

sv_active
Серверні з’єднання, які пов’язані з клієнтом.

sv_idle
З’єднання з сервером, які не використовуються та негайно використовуються для запитів клієнта.

sv_used
З’єднання з сервером, які неактивні більше ніж server_check_delay, тому їм потрібно
server_check_query щоб запустити на ньому, перш ніж його можна буде використовувати.

sv_tested
Підключення до сервера, які зараз запущені server_reset_query or
server_check_query.

sv_login
Підключення до сервера в даний час у процесі входу.

maxwait
Скільки часу очікував перший (найстаріший) клієнт у черзі, в секундах. Якщо це почнеться
збільшується, то поточний пул серверів недостатньо швидко обробляє запити.
Причиною може бути або перевантажений сервер, або просто занадто малий pool_size установка.

pool_mode
Використовуваний режим об’єднання.

ШОУ СПИСКИ;
Показати таку внутрішню інформацію в стовпцях (а не в рядках):

базами даних
Кількість баз даних.

користувачі Кількість користувачів.

басейни Кількість басейнів.

вільні_клієнти
Кількість безкоштовних клієнтів.

використані_клієнти
Кількість використаних клієнтів.

login_clients
Кількість клієнтів у Логін стан.

безкоштовні_сервери
Кількість безкоштовних серверів.

використані_сервери
Кількість використаних серверів.

ШОУ КОРИСТУВАЧІ;
ім'я Ім'я користувача

pool_mode
Перевизначає параметр pool_mode користувача або NULL, якщо замість нього буде використано значення за замовчуванням.

ШОУ БАЗИ ДАНИХ;
ім'я Ім'я налаштованого запису бази даних.

господар Хост pgbouncer підключається до.

порт Порт pgbouncer підключається до.

база даних
Фактична назва бази даних, до якої підключається pgbouncer.

force_user
Коли користувач є частиною рядка підключення, з’єднання між pgbouncer і
PostgreSQL примусово передається даному користувачеві, незалежно від того, який користувач клієнта.

pool_size
Максимальна кількість підключень до сервера.

pool_mode
Перевизначення pool_mode бази даних або NULL, якщо замість нього буде використано значення за замовчуванням.

ШОУ FDS;
Внутрішня команда - показує список fds, які використовуються з внутрішнім станом до них.

Коли підключений користувач має ім’я користувача "pgbouncer", підключається через сокет Unix і має
той самий UID, що й запущений процес, фактичні fds передаються через з'єднання. Це
Механізм використовується для перезавантаження в режимі онлайн. Примітка: це не працює на машинах Windows.

Ця команда також блокує внутрішній цикл подій, тому її не слід використовувати, коли працює PgBouncer
в вживанні.

fd Числове значення дескриптора файлу.

завдання Однією з пулер, клієнт or сервер.

користувач Користувач підключення за допомогою FD.

база даних
База даних підключення за допомогою FD.

адр IP-адреса підключення за допомогою FD, UNIX якщо використовується Unix-сокет.

порт Порт, який використовується для підключення за допомогою FD.

відмінити Ключ скасування для цього з'єднання.

за посиланням fd для відповідного сервера/клієнта. NULL, якщо неактивний.

ШОУ CONFIG;
Показати поточні налаштування конфігурації, по одному в рядку, з такими стовпцями:

ключ Ім'я змінної конфігурації

значення Значення конфігурації

мінливий
Або так or немає, показує, чи можна змінити змінну під час роботи. Якщо немає,
змінну можна змінити тільки під час завантаження.

ШОУ DNS_HOSTS;
Показати імена хостів у кеші DNS.

ім'я хоста
Ім'я хоста.

ТТЛ Скільки секунд до наступного пошуку.

адреси Список адрес, розділених комами.

ШОУ DNS_ZONES
Показати зони DNS в кеші.

назва зони
Назва зони.

послідовний Поточний серіал.

вважати Імена хостів, що належать до цієї зони.

Процес управління Команди
PAUSE [дб];
PgBouncer намагається відключитися від усіх серверів, спочатку очікуючи завершення всіх запитів.
Команда не повернеться до завершення всіх запитів. Використовувати під час
перезапуск бази даних.

Якщо вказано ім’я бази даних, буде призупинено лише цю базу даних.

ВІМКНУТИ db;
Відхилити всі нові клієнтські підключення до даної бази даних.

ENABLE db;
Дозволити нові клієнтські підключення після попереднього ВІМКНУТИ команда

Вбити db;
Негайно відключіть усі клієнтські та серверні підключення до даної бази даних.

ПРИВЕРНУТИ;
Усі буфери сокетів очищуються, і PgBouncer припиняє прослуховувати дані про них. The
команда не повернеться, поки всі буфери не будуть порожні. Для використання під час PgBouncer
онлайн перезавантаження.

РЕЗЮМЕ [дб];
Відновити роботу з попередньої PAUSE or ПРИВЕРНУТИ команда

ЗАКРИТИ;
Процес PgBouncer завершиться.

ПЕРЕЗАвантаження;
Процес PgBouncer перезавантажить свій файл конфігурації та оновить параметри, що змінюються.

Сигнали
ЗДИХАННЯ Перезавантажте конфігурацію. Те саме, що видати команду ПЕРЕЗАвантаження; на консолі.

SIGINT Безпечне відключення. Те саме, що видавати ПАУЗА; та ЗАКРИТИ; на консолі.

СИГТЕРМ
Негайне відключення. Те саме, що видавати ЗАКРИТИ; на консолі.

Лібевент налаштування
З libevent docs:

Можна вимкнути підтримку epoll, kqueue, devpoll, poll
або виберіть, встановивши змінну середовища EVENT_NOEPOLL,
EVENT_NOKQUEUE, EVENT_NODEVPOLL, EVENT_NOPOLL або EVENT_NOSELECT,
відповідно.

Встановивши змінну середовища EVENT_SHOW_METHOD, libevent
відображає метод сповіщення ядра, який він використовує.

Використовуйте pgbouncer онлайн за допомогою служб onworks.net