Тонкие настройки для резервного копирования

В таблице описаны тонкие настройки модуля для резервного копирования Arenadata DB, Greengage и Greenplum (см. Резервное копирование в Tucana).

Поведение настроек и их совместимость между собой совпадают с поведением и совместимостью одноименных ключей утилиты gpbackup.

Таблица 1. Тонкие настройки модуля для резервного копирования
Параметр Описание

compression_level

Степень сжатия файлов данных (уровень 0 означает, что сжатие отключено)

Возможные значения

от 0 до 9

По умолчанию

0

compression_type

Тип сжатия файлов данных

Возможные значения

gzip, zstd

По умолчанию

gzip

data_only

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

Возможные значения

true, false

По умолчанию

false

exclude_schema_file

Текстовый файл, содержащий список схем, которые не должны попасть в резервную копию

exclude_table_file

Текстовый файл, содержащий список таблиц, которые не должны попасть в резервную копию

include_schema_file

Текстовый файл, содержащий список схем, которые должны попасть в резервную копию

include_table_file

Текстовый файл, содержащий список таблиц, которые должны попасть в резервную копию

jobs

Количество параллельных подключений к базе данных. Увеличение этого числа может повысить скорость выполнения операции

Возможные значения

от 1 до 64.

Рекомендуемые значения

до 8.

По умолчанию

1.

leaf_partition_data

Создаёт отдельный файл данных для каждого партиции партиционированной таблицы. Без этой опции вся таблица сохраняется в один файл данных на сегмент

metadata_only

Создавать только файлы метаданных (DDL), необходимые для воссоздания объектов базы данных, но не выполнять резервное копирование данных таблицы

Возможные значения

true, false

По умолчанию

false

no_inherits

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

plugin_config

Путь к файлу настроек расширения gpbackup. Требуется для сохранения резервной копии напрямую в клиентские объектные хранилища. Для восстановления резервной копии, созданной с расширением gpbackup, потребуется то же самое расширение.

without_globals

Пропустить глобальные системные объекты базы данных во время резервного копирования

Возможные значения

true, false

По умолчанию

false

with_stats

Включить в резервную копию статистику базы данных

Путь к текстовому файлу, указываемому вместе с опциями exclude_schema_file, exclude_table_file, include_schema_file и include_table_file должен быть полным. Сам файл должен находиться в директории, в которую предоставлен доступ пользователю gpadmin.

В файле, указываемом вместе с опцией exclude_schema_file, не должно быть завершающих строк. Если в имени схемы используется какой-либо символ кроме a-z, 0-9 и _, это имя необходимо заключить в двойные кавычки. Данную опцию нельзя комбинировать с опциями include_schema_file и include_table_file.

Каждая строка в файле, указываемом вместе с опцией exclude_table_file, должна определять одну таблицу в формате <имя-схемы>.<имя-таблицы>. В файле не должно быть завершающих строк. Если в имени таблицы или схемы используется какой-либо символ, кроме a-z, 0-9 и _, это имя необходимо заключить в двойные кавычки. Данную опцию нельзя комбинировать с опциями exclude_schema_file и include_table_file.

В файле, указываемом вместе с опцией include_schema_file, не должно быть завершающих строк. Если в имени схемы используется какой-либо символ кроме a-z, 0-9 и _, это имя необходимо заключить в двойные кавычки. Данную опцию нельзя комбинировать с опциями exclude_schema_file и include_schema_file.

Каждая строка в файле, указываемом вместе с опцией include_table_file, должна определять одну таблицу в формате <имя-схемы>.<имя-таблицы>. В файле не должно быть завершающих строк. Если в имени таблицы или схемы используется какой-либо символ кроме a-z, 0-9 и _, это имя необходимо заключить в двойные кавычки. Данную опцию нельзя комбинировать с опциями exclude_table_file и include_schema_file.

Если при создании резервной копии базы данных была использована одна из опций фильтрации: exclude_schema_file, exclude_table_file, include_schema_file, include_table_file, without_globals или metadata_only, то перед восстановлением из данной резервной копии оригинальная база данных должна быть удалена и создана вручную. В качестве альтернативы восстановление из резервной копии может быть инициировано с установленной опцией drop_db (Тонкие настройки для восстановления резервной копии).

Если при создании резервной копии базы данных был установлен флаг without_globals, то перед восстановлением из данной резервной копии подразумевается, что оригинальная база данных удалена и создана вручную. В качестве альтернативы восстановление из резервной копии может быть инициировано с установленной опцией drop_db (Тонкие настройки для восстановления резервной копии).

Если при создании резервной копии базы данных был установлен флаг metadata_only, то перед восстановлением из данной резервной копии подразумевается, что оригинальная база данных удалена и создана вручную. В качестве альтернативы восстановление из резервной копии может быть инициировано с установленной опцией drop_db (Тонкие настройки для восстановления резервной копии).

Для резервных копий, созданных при включенной опции data_only:

  • восстанавливаемая база данных должна существовать, иначе задача восстановления завершится с ошибкой;

  • восстанавливаемая БД не должна содержать данных. При восстановлении резервной копий данные будут записаны поверх существующих, что может привести к дублированию;

  • восстанавливаемая база данных может содержать метаданные. Для этого она должна быть восстановлена из резервной копии с использованием опции metadata_only.

Если для опции jobs указано значение выше 1, то все операции записи в базу данных должны быть приостановлены. Утилита gpbackup блокирует таблицы, для которых выполняется резервное копирование. Если gpbackup не может заблокировать таблицу(ы), для которой(х) создается резервная копия, утилита завершит работу, и задача на создание резервной копии завершится с ошибкой.

Если для опции jobs указано значение выше 1 и установлен флаг metadata_only, то значение флага metadata_only будет проигнорировано ввиду несовместимости одноименных опций внутри утилиты gpbackup.

При указании значения для опции jobs выше 1, при работе утилиты gpbackup возможен сценарий взаимоблокировки, при котором процесс создания резервной копии зависнет. В этом случае задача на выполнение резервного копирования будет находиться в статусе execution до её принудительного завершения сервером RuBackup. Подробнее о возможной проблеме при работе утилиты gpbackup можно прочитать в документации.