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
FAQ