3.5. Создание резервной копии #
Для создания резервной копии выполните следующую команду:
pg_probackup3 backup -Bкаталог_копий--instance=имя_экземпляра-bрежим_копирования[-sисточник_копирования] [-iид_резервной_копии]
режим_копирования может принимать следующие значения: FULL, DELTA и PTRACK.
Для параметра -s/--backup-source можно установить значения pro (режим PRO), direct (режим DIRECT) или base (режим BASE). Если этот параметр опущен, pg_probackup3 по умолчанию работает в режиме PRO и переключается на режим BASE в качестве резервного варианта, если PRO недоступен (не настроен pgpro_bindump).
Примечание
В режиме доступа к серверу BASE поддерживается резервное копирование только в режимах FULL и DELTA.
Примечание
Можно создавать несколько резервных копий одного и того же кластера баз данных параллельно, при условии, что каждая копия сохраняется в отдельный подкаталог каталога резервных копий. Такие копии независимы и не влияют друг на друга.
Одна полная резервная копия (FULL) может иметь несколько независимых ветвей с цепочками инкрементальных резервных копий, которые вместе образуют древовидную структуру (см. Подраздел 5.1.1). По умолчанию при создании новой инкрементальной резервной копии pg_probackup3 использует в качестве родительской самую последнюю рабочую копию в цепочке. Чтобы ответвиться от конкретной резервной копии, укажите её идентификатор с помощью параметра --parent-backup-id. Например:
pg_probackup3 backup -B путь/к/каталогу_копий --instance=dev -b DELTA --parent-backup-id=second-delta-1Примечание
Родительскую резервную копию можно указать только для инкрементальных копий. У полных резервных копий родителя нет.
В pg_probackup3 цепочку инкрементальных резервных копий можно объединять, не затрагивая полную резервную копию. За подробностями обратитесь к Подразделу 5.1.3.2.
Некоторые параметры можно не указывать, в зависимости от цели пользователя:
Если
режим_копированияне указан, по умолчанию используется режимFULL.pro— значение по умолчанию дляисточника_копирования.Если идентификатор резервной копии не указан явно в теле запроса,
backup_idпримет значение даты и времени, когда резервная копия была создана.Если идентификатор резервной копии указан и включает в себя путь к каталогу,
backup_dirиinstance_nameможно не указывать. Например:-i /mnt/ramdisk/backups/2.backup.Если путь к каталогу данных не указан ни через
каталог_копий, ни через параметр--backup-id, текущий каталог будет использоваться в качестве каталога по умолчанию.Если опустить идентификатор родительской копии (
--parent-backup-id) при выполнении инкрементального копирования, pg_probackup3 использует последнюю рабочую копию из цепочки копий. Если родительскую резервную копию найти не удастся, процесс копирования завершится ошибкой.Если указан параметр
--from-full, инкрементальная резервная копия будет создана из последней родительской полной копии.
За полным списком параметров команды backup обратитесь к её описанию.
3.5.1. Режим доставки WAL ARCHIVE #
Режим ARCHIVE используется в качестве режима доставки WAL по умолчанию.
Чтобы создать полную копию в режиме доставки WAL ARCHIVE, выполните:
pg_probackup3 backup -Bкаталог_копий--instance=имя_экземпляра-b FULL
Резервное копирование в режиме ARCHIVE требует организации непрерывного архивирования, посредством которого считываются сегменты WAL, требующиеся для восстановления согласованного состояния кластера на момент создания копии.
3.5.2. Режим доставки WAL STREAM #
Например, чтобы сделать полную резервную копию в потоковом режиме, добавьте флаг --stream к команде, показанной выше:
pg_probackup3 backup -Bкаталог_копий--instance=имя_экземпляра-b FULL --stream
В отличие от резервных копий, созданных в режиме ARCHIVE, копии, созданные в режиме STREAM включают все сегменты WAL, необходимые для восстановления согласованного состояния кластера на момент создания копии.
В процессе выполнения команды backup pg_probackup3 передаёт файлы WAL, содержащие записи от Start LSN до Stop LSN, в файл с резервной копией.
Даже если вы используете непрерывное архивирование, резервное копирование в режиме STREAM может быть полезно в следующих случаях:
Резервные копии типа
STREAMмогут быть восстановлены на сервере, не имеющем файлового доступа к архиву WAL.Данные копии позволяют восстановить состояние кластера на тот момент времени, для которого уже нет файлов WAL.
3.5.3. Внешние каталоги #
Чтобы создать резервную копию каталога, расположенного вне каталога данных, используйте необязательный параметр -E/--external-dirs, который задаёт путь к этому каталогу. Если нужно добавить более одного внешнего каталога, можно указать несколько путей, разделённых двоеточиями, в системах Linux и точкой с запятой в Windows.
Например, чтобы в системе Linux включить каталоги /etc/dir1 и /etc/dir2 в полную копию экземпляра имя_экземпляра, которая будет размещаться в каталоге_копий, выполните:
pg_probackup3 backup -Bкаталог_копий--instance=имя_экземпляра-b FULL --external-dirs=/etc/dir1:/etc/dir2
Например, чтобы включить каталоги C:\dir1 и C:\dir2 в полную копию, в Windows нужно выполнить:
pg_probackup3 backup -Bкаталог_копий--instance=имя_экземпляра-b FULL --external-dirs=C:\dir1;C:\dir2
Для каждого внешнего каталога pg_probackup3 создаёт отдельный подкаталог в каталоге резервной копии и рекурсивно копирует в него всё содержимое внешнего каталога. Так как внешние каталоги, попадающие в разные резервные копии, не обязательно должны быть одинаковыми, при восстановлении кластера из инкрементальной копии будут восстановлены только те каталоги, которые относятся именно к ней. Внешние каталоги, сохранённые в предыдущих копиях, восстановлены не будут.
Чтобы нужные каталоги включались в каждую резервную копию вашего экземпляра, их можно указать в файле конфигурации pg_probackup3.conf с помощью команды set-config и параметра -E/--external-dirs.
Примечание
Внешние каталоги не поддерживаются в режиме доступа к серверу BASE. При использовании режима BASE внешние каталоги, указанные через --external-dirs, молча игнорируются. Чтобы включить внешние каталоги, используйте режим DIRECT (-s direct).
3.5.4. Частичное резервное копирование #
Вы можете копировать отдельные базы данных с помощью параметров --db-include-oid и --db-exclude-oid.
Важно
Важно учитывать следующие особенности операции:
Частичное резервное копирование в настоящее время поддерживается только в режиме DIRECT.
Исключённые базы данных необходимо удалить вручную с помощью команды
DROP DATABASE.После частичного резервного копирования можно выполнить нечастичное восстановление, в результате чего будет создан экземпляр только с включёнными базами данных.
Чтобы создать резервную копию только определённых баз данных, выполните команду backup со следующими параметрами:
pg_probackup3 backup -Bкаталог_копий--instance=имя_экземпляра--db-include-oid=dboid
Чтобы исключить одну или несколько баз данных из числа копируемых, используйте параметр --db-exclude-oid:
pg_probackup3 backup -Bкаталог_копий--instance=имя_экземпляра--db-exclude-oid=dboid
Параметры --db-include-oid и --db-exclude-oid можно указывать многократно, но они не могут использоваться вместе. Например, чтобы создать резервную копию баз данных db1 (OID dboid1) и db2 (OID dboid2), выполните следующую команду:
pg_probackup3 backup -Bкаталог_копий--instance=имя_экземпляра--db-include-oid=dboid1 --db-include-oid=dboid2
Чтобы исключить те же базы данных, что и в предыдущем примере, выполните:
pg_probackup3 backup -Bкаталог_копий--instance=имя_экземпляра--db-exclude-oid=dboid1 --db-exclude-oid=dboid2