2.4. Настройка pg_probackup3 #

Проинициализировав каталог резервных копий и добавив определение копируемого экземпляра, вы можете использовать файл pg_probackup3.conf в каталоге каталог_копий/backups/имя_экземпляра для тонкой настройки конфигурации pg_probackup3 этого экземпляра.

Например, команда backup работает через обычное подключение Postgres Pro. Чтобы каждый раз не задавать параметры подключения в командной строке, вы можете определить их в файле конфигурации pg_probackup3.conf с помощью команды set-config.

Изначально pg_probackup3.conf содержит следующие параметры:

  • PGDATA — путь к каталогу данных кластера, который будет копироваться.

  • system-identifier — уникальный идентификатор экземпляра Postgres Pro.

Вы можете дополнительно установить параметры хранения копий, ведения журнала и сжатия, используя команду set-config:

pg_probackup3 set-config -B каталог_копий --instance=имя_экземпляра
[--external-dirs=путь_внешнего_каталога] [параметры_подключения] [параметры_сжатия] [параметры_хранения] [параметры_журнала]

Чтобы просмотреть текущие параметры, выполните эту команду:

pg_probackup3 show-config -B каталог_копий --instance=имя_экземпляра

Параметры, заданные в pg_probackup3.conf, можно переопределить, задавая соответствующие переменные окружения или параметры командной строки при вызове команд pg_probackup3.

Примечание

Редактировать pg_probackup3.conf вручную не рекомендуется. Изменения файла конфигурации с помощью команды set-config исключает возможность случайных опечаток.

2.4. Configuring pg_probackup3 #

Once a backup catalog is initialized and a new backup instance is added, you can use the pg_probackup3.conf configuration file located in the backup_dir/backups/instance_name directory to fine-tune pg_probackup3 configuration of this instance.

For example, the backup command uses a regular Postgres Pro connection. To avoid specifying connection options each time on the command line, you can set them in the pg_probackup3.conf configuration file using the set-config command.

Initially, pg_probackup3.conf contains the following settings:

  • PGDATA — the path to the data directory of the cluster to back up.

  • system-identifier — the unique identifier of the Postgres Pro instance.

Additionally, you can define retention, logging, and compression settings using the set-config command:

pg_probackup3 set-config -B backup_dir --instance=instance_name
[--external-dirs=external_directory_path] [connection_options] [compression_options] [retention_options] [logging_options]

To view the current settings, run the following command:

pg_probackup3 show-config -B backup_dir --instance=instance_name

You can override the settings defined in pg_probackup3.conf when running pg_probackup3 commands via the corresponding environment variables and/or command line options.

Note

It is not recommended to edit pg_probackup3.conf manually. Modifying the configuration file using the set-config command prevents accidental typographical errors.

FAQ