Описание

pg_rewind - это инструмент для синхронизации кластера PostgreSQL с другой копией того же кластера, после того как временные линии кластеров разошлись. Типичный сценарий - восстановление работы старого основного сервера после сбоя в качестве резервного сервера, который следует за новым основным сервером.

После успешного перемотки состояние целевого каталога данных аналогично базовой резервной копии исходного каталога данных. В отличие от создания новой базовой резервной копии или использования инструмента rsync, pg_rewind не требует сравнения или копирования неизмененных блоков отношений в кластере. Копируются только измененные блоки из существующих файлов отношений; все остальные файлы, включая новые файлы отношений, файлы конфигурации и сегменты WAL, копируются полностью. Поэтому операция перемотки значительно быстрее других подходов, когда база данных большая и только небольшая часть блоков отличается между кластерами.

pg_rewind анализирует историю временных линий исходного и целевого кластеров, чтобы определить точку их расхождения, и ожидает наличия WAL-файлов в каталоге pg_wal целевого кластера, которые простираются до точки расхождения. Точка расхождения может быть найдена на целевой временной линии, исходной временной линии или их общем предке. В типичном сценарии сбоя, когда целевой кластер был выключен вскоре после расхождения, это не является проблемой, но если целевой кластер работал долгое время после расхождения, его старые WAL-файлы могут отсутствовать. В этом случае вы можете вручную скопировать их из архива WAL в каталог pg_wal или запустить pg_rewind с опцией -c, чтобы автоматически получить их из архива WAL. Использование pg_rewind не ограничено только ситуациями сбоя, например, резервный сервер может быть повышен в статус основного, выполнить некоторые транзакции записи, а затем откатиться, чтобы снова стать резервным.

После запуска pg_rewind воспроизведение WAL должно быть завершено, чтобы каталог данных находился в согласованном состоянии. Когда целевой сервер снова запускается, он входит в режим восстановления из архива и воспроизводит все WAL, сгенерированные на исходном сервере с момента последней контрольной точки до точки расхождения. Если некоторые WAL больше не доступны на исходном сервере во время выполнения pg_rewind и, следовательно, не могут быть скопированы сессией pg_rewind, они должны быть доступны при запуске целевого сервера. Это можно сделать, создав файл recovery.signal в целевом каталоге данных и настроив подходящую restore_command в postgresql.conf.

pg_rewind требует, чтобы целевой сервер либо имел включенную опцию wal_log_hints в файле postgresql.conf, либо включенные контрольные суммы данных при инициализации кластера с помощью initdb. По умолчанию ни одно из этих условий не выполняется. Опция full_page_writes также должна быть установлена в on, но она включена по умолчанию.

Опции

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

Окружение

Когда используется опция --source-server, pg_rewind также использует переменные среды, поддерживаемые libpq (см. Раздел 31.15).

Переменная среды PG_COLOR определяет, следует ли использовать цвет в диагностических сообщениях. Возможные значения: always, auto и never.

Примечания

При выполнении pg_rewind с использованием онлайн-кластера в качестве источника, можно использовать роль с достаточными правами для выполнения функций, используемых pg_rewind на исходном кластере, вместо суперпользователя. Вот как создать такую роль, названную rewind_user здесь:

CREATE USER rewind_user LOGIN;
GRANT EXECUTE ON function pg_catalog.pg_ls_dir(text, boolean, boolean) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_stat_file(text, boolean) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_read_binary_file(text) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_read_binary_file(text, bigint, bigint, boolean) TO rewind_user;