pg_standby. Создание сервера «теплого» резерва#

В исходном дистрибутиве установлено по умолчанию: да.

Связанные компоненты: отсутствуют.

Схема размещения: не используется.

Программа pg_standby поддерживает создание сервера и предназначена для:

  • применения в производственной среде;

  • использования в качестве настраиваемой заготовки, когда требуются специальные модификации.

pg_standby ожидает выполнения команды restore_command, которая нужна для перехода от стандартного восстановления архива к режиму так называемого «теплого» резерва.

Его настройка описана в разделе 27.2.4 документации оригинальной PostgreSQL.

Синтаксис:

pg_standby [параметр...] расположение_архива следующий_файл_wal каталог_wal [файл_перезапуска_wal]

Если указывается файл_перезапуска_wal, тогда все файлы журнала предзаписи (WAL), предшествующие указанному, будут удалены из каталога расположение_архива. Аргумент обычно указывается с помощью макроса %r.

Удаление предыдущих журналов позволяет сократить число сохраняемых файлов без потери возможности восстановления при перезапуске. Такой вариант использования уместен, когда расположение_архива указывает на область рабочих файлов конкретного резервного сервера, но не когда расположение_архива — это каталог с архивом WAL для долговременного хранения.

Логика работы приложения pg_standby предполагает, что каталог, заданный аргументом расположение_архива, доступен для чтения владельцу серверного процесса.

Кроме того, если указывается аргумент файл_перезапуска_wal (или ключ -k), то каталог расположение_архива должен быть доступен для записи.

При выходе из строя ведущего сервера переключение на сервер «теплого резерва» возможно двумя способами:

  1. Умное переключение (Smart Failover).

    При умном переключении сервер включается в работу, применив изменения из всех файлов WAL, имеющихся в архиве. В результате умного переключения данные не теряются, даже если данный резервный сервер отстал. Если применить нужно большое количество изменений WAL, подготовка к работе может быть длительной. Чтобы вызвать умное переключение, нужно создать файл-триггер, содержащий слово smart, либо просто пустой файл.

  2. Быстрое переключение (Fast Failover).

    При быстром переключении сервер включается в работу немедленно. Все не примененные файлы WAL в архиве будут игнорироваться, и все транзакции в этих файлах будут потеряны. Чтобы вызвать быстрое переключение, создайте файл-триггер и запишите в него слово fast. Программу pg_standby можно настроить так, чтобы быстрое переключение происходило автоматически, если за определенное время не появляется новый файл журнала WAL.

Параметры

Расширение pg_standby принимает следующие аргументы командной строки:

Аргумент

Описание

-c

Применяет для восстановления файлов WAL из архива команду cp или copy; параметр бесполезен, поскольку в данный момент поддерживается только это поведение

-d

Выводит подробные отладочные сообщения в stderr

-k

Задает количество файлов WAL, предшествующих текущему журналу; параметр оставляет не больше заданного числа файлов WAL в каталоге расположение_архива, предшествующие – удалить.
– 0, «ноль» (значение по умолчанию) означает, что не нужно удалять никакие файлы из каталога расположение_архива;
данный параметр будет игнорироваться, если указан файл_перезапуска_wal – такой способ более точно определяет правильную точку отсечения архива.
Слишком низкое значение параметра может привести к удалению файлов, которые могут потребоваться для перезапуска резервного сервера.
Слишком высокое значение параметра может быть причиной неэффективного использования дискового пространства архива

-r макс_повторов

Устанавливает максимальное количество повторов команды copy в случае ошибки. После каждой ошибки программа приостанавливается на время_задержки * число_повторов; время ожидания постепенно увеличивается.
По умолчанию программа ожидает 5, 10, 15 секунд, а затем сообщает резервному серверу об ошибке – это событие будет воспринято как завершение восстановления, и в результате резервный сервер полностью включится в работу.
Значение по умолчанию: 3

-s время_задержки

Задает количество секунд для выдержки паузы между проверками наличия файла WAL в архиве.
Допустимые значения: до 60.
Значение по умолчанию: 5
подробности в документации оригинального PostgreSQL: Раздел 26.2

-t файл_триггер

Указывает файл-триггер, при появлении которого должна начаться отработка отказа. Имя этого файла рекомендуется выбирать по определенной схеме, позволяющей однозначно понять, для какого сервера вызывается отработка отказа, когда таких серверов в одной системе несколько. Например, /tmp/pgsql.trigger.5432
приложение поддерживает параметр recovery_end_command, в котором можно задать команду для удаления файла-триггера во избежание ошибок

-V
--version

Выводит версию pg_standby и завершает работу

-w макс_время_ожидания

Задает максимальное время ожидания (в секундах) следующего файла WAL, по истечении которого будет произведено быстрое переключение.
0, «ноль» (значение по умолчанию) означает бесконечное ожидание.
Подробности в документации оригинального PostgreSQL: Раздел 26.2

-?
--help

Выводит справку об аргументах командной строки pg_standby и завершает работу

Доработка#

Доработка не проводилась.

Ограничения#

Программа pg_standby предназначена для работы с ядром СУБД PostgreSQL версии 8.2 или новее.

Установка#

Установка не требуется.

Исполняемый файл pg_standby расположен в каталоге $PGHOME/bin/.

Настройка#

Чтобы настроить резервный сервер на использование pg_standby, поместите в файл конфигурации резервного сервера $PGDATA/postgresql.conf строку:

restore_command = 'pg_standby каталог_архива %f %p %r'

где каталог_архива — каталог, из которого должны восстанавливаться сегменты журнала предзаписи (WAL).

Использование модуля#

В операционных системах семейства Unix можно использовать команды:

archive_command = 'cp %p .../archive/%f'

restore_command = 'pg_standby -d -s 2 -t /tmp/pgsql.trigger.5442 .../archive %f %p %r 2>>standby.log'

recovery_end_command = 'rm -f /tmp/pgsql.trigger.5442'

Предполагается, что каталог архива физически располагается на резервном сервере. Команда archive_command обращается к резервному серверу посредством сетевого доступа. По отношению к самому резервному серверу эти файлы будут являться локальными, для чего применяется создание ссылок (ln).

Приведенные выше команды будут выполнять действия:

  • выводить отладочную информацию в standby.log;

  • ждать 2 секунды между проверками появления следующего файла WAL;

  • прекращать ожидание, только когда появляется файл-триггер с именем /tmp/pgsql.trigger.5442, и выполнять переключение согласно его содержимому;

  • удалять файл-триггер после завершения восстановления;

  • удалять лишние файлы из каталога архива.

Ссылки на документацию разработчика#

Дополнительно поставляемый модуль pg_standby: https://www.postgresql.org/docs/15/pgstandby.html.