20.4 Backup Repository Options — MySQL Enterprise Backup 8.4

20.4 Параметры репозитория резервных копий

Эти параметры задают различные параметры, связанные с образом резервной копии или каталогом, или с тем, как резервная копия будет восстановлена. Как правило, --backup-image и --backup-dir являются единственными параметрами из этой группы, которые необходимо указать при использовании mysqlbackup.

Параметры репозитория резервных копий используются со следующими операциями:

Операции резервного копирования: backup, backup-and-apply-log, backup-to-image.
Операции восстановления: copy-back, copy-back-and-apply-log.

Параметры репозитория резервных копий разделены на две группы: первая определяет структуру резервной копии, а вторая предоставляет информацию об исходной структуре данных на сервере, с которого была сделана резервная копия, для будущих операций с резервной копией.

Следующие параметры определяют структуру резервной копии:

--backup-image=IMAGE

Формат командной строки --backup-image=IMAGE

Тип Имя файла

Укажите имя файла, используемого для резервного копирования одного файла, восстановления или другой операции с одним файлом.

За исключением случаев потоковой передачи резервной копии с помощью --backup-image=-, если --backup-image не задает полное имя пути, вот как mysqlbackup интерпретирует значение параметра:
- - Для операций backup-to-image, mysqlbackup использует значение --backup-image в качестве пути, относительного к расположению, указанному параметром --backup-dir. Если также используется параметр --with-timestamp, резервная копия сохраняется в подкаталоге с меткой времени в его имени под каталогом.
  - Для операций copy-back-and-apply-log и операций с одним файлом, отличных от backup-to-image, mysqlbackup использует значение --backup-image в качестве пути, относительного к текущей рабочей директории, в которой выполняется команда mysqlbackup.
По умолчанию резервная копия одного файла передаётся в стандартный вывод, так что вы можете передать её напрямую другим командам, таким как резервное копирование на ленту или сетевая команда, связанная с ssh.

Вы можете необязательно добавить префикс к имени файла file:, чтобы указать ввод-вывод файлов (по умолчанию). Для резервного копирования на ленту добавьте префикс sbt: к имени файла. Подробности о резервном копировании на ленту см. в разделе 4.3.1.2, «Резервное копирование на ленту».
--backup_dir=PATH

То же, что и --backup-dir. Каталог, в котором хранятся данные и метаданные резервной копии, постоянно или временно. Это важный параметр, необходимый для большинства операций резервного копирования и восстановления.

Параметр используется по-разному в разных операциях и в разных ситуациях:
- Для резервного копирования в один файл (включая инкрементальное, сжатое, зашифрованное и облачное резервное копирование): Используйте --backup-dir, чтобы указать временную папку для сохранения метаданных резервной копии (включая журнал сообщений mysqlbackup, начало и конец и так далее) и некоторых временных выводов. Данные резервной копии вместе с копией метаданных будут сохранены в одном файле, имя которого указано параметром --backup-image.
  
  Однако, если --backup-image не задаёт полное имя пути, mysqlbackup фактически примет значение --backup-image как путь, относительный к каталогу, указанному параметром --backup-dir, и, таким образом, сохранит резервную копию одного файла в --backup-dir (или, если используется параметр --with-timestamp, в подкаталоге, созданном под --backup-dir, который содержит метку времени в его имени).
- Для резервного копирования в каталог: Используйте --backup-dir, чтобы указать каталог для хранения данных и метаданных резервной копии (включая журнал сообщений mysqlbackup, начало и конец и так далее). Каталог, указанный параметром --backup-dir, не может быть подкаталогом каталога, указанного параметром --datadir.
  
  Когда также указан параметр --with-timestamp, создаётся дополнительный уровень подкаталога с меткой времени в его имени под --backup-dir (см. описание параметра --with-timestamp для подробностей). Если не используется параметр --with-timestamp, каталог, указанный параметром --backup-dir, должен быть пустым, иначе операция резервного копирования завершится ошибкой.
- Для восстановления резервной копии одного файла (включая инкрементальное, сжатое, зашифрованное и облачное резервное копирование): При использовании copy-back-and-apply-log для восстановления резервной копии одного файла, используйте --backup-dir, чтобы указать временную папку для хранения временных данных операции восстановления. Каталог, указанный параметром --backup-dir, должен быть пустым — если используется непустой каталог, операция восстановления всё равно будет выполнена, но данные восстановления могут быть повреждены.
  
  При восстановлении резервной копии одного файла, созданной с настройкой параметра use-tts=with-minimum-locking, папка, указанная параметром --backup-dir, также используется для временного извлечения всех таблиц из резервной копии и выполнения операции apply-log, чтобы данные были актуальны перед их восстановлением в каталог данных сервера.
- Для восстановления каталога резервной копии: Используйте --backup-dir, чтобы указать местоположение каталога резервной копии, из которого данные будут восстановлены на сервер.
backup_innodb_data_home_dir=PATH

Каталог, в котором должны храниться файлы данных InnoDB резервной копии. Укажите параметр, если вы хотите поместить файлы данных в другое место, отличное от места по умолчанию (которое является backup-dir/datadir). Если значение параметра отличается от backup-dir/datadir, оно сохраняется в файл backup-my.cnf как innodb_data_home_dir для информации, чтобы mysqlbackup мог понять структуру резервной копии при выполнении различных операций с ней. Вместе с параметром backup_innodb_data_file_path он определяет фактические пути к файлам данных InnoDB внутри резервной копии.

Значение параметра определяется следующим образом:
- Если backup_innodb_data_home_dir не указан, его значение будет backup-dir/datadir.
- Если backup_innodb_data_home_dir — абсолютный путь, его значение используется как есть, если он указывает на расположение, которое находится под backup-dir, но не равно backup-dir/datadir, в этом случае mysqlbackup выведет ошибку и прервёт операцию.
- Если backup_innodb_data_home_dir — относительный путь, путь считается относительным к (то есть под) backup-dir, и он должен указывать на backup-dir/datadir, иначе mysqlbackup выведет ошибку и прервёт операцию.
- Пустая строка (“”) для backup_innodb_data_home_dir означает, что значение backup_innodb_data_file_path должно рассматриваться как абсолютный путь.
Этот параметр применим только для операций резервного копирования; во время восстановления файлы данных InnoDB восстанавливаются в каталог данных, указанный параметром --datadir, если во время восстановления не указано другое местоположение с помощью параметра --innodb_data_home_dir.

Формат командной строки	`--backup-image=IMAGE`
Тип	Имя файла

backup_innodb_data_file_path=VALUE

Имена и размеры файлов данных InnoDB. Примеры:
```
ibdata1:32M;ibdata2:32M:autoextend
/abs/path/ibdata1:32M:autoextend
innodb-dir/ibdata1:32M:autoextend
```
Этот параметр вместе с backup_innodb_data_home_dir определяет, где в репозитории резервной копии хранятся файлы данных InnoDB. Любой путь к файлу, указанный с этим параметром, считается относительным к значению параметра backup_innodb_data_home_dir (это верно даже если путь к файлу указан в виде абсолютного пути, например, /abs/path/ibdata1:32M:autoextend). Чтобы указать в резервной копии InnoDB данные файлов с истинно абсолютными путями с этим параметром, необходимо установить параметр backup_innodb_data_home_dir в значение "" [пустая строка], помимо использования абсолютного пути для этого параметра.

Если параметр не указан, он наследует значение из значения параметра на сервере, с которого производится резервное копирование. Если как источник, так и место назначения резервной копии пытаются использовать одни и те же абсолютные пути, которые указывают на те же файлы, резервное копирование отменяется.

Значение параметра сохраняется в файл backup-my.cnf как innodb_data_file_path для информации, чтобы mysqlbackup мог понимать структуру резервной копии при выполнении различных операций с резервной копией.
backup_innodb_log_group_home_dir=PATH

Каталог, в котором будут храниться журналы InnoDB резервной копии. Укажите этот параметр только в том случае, если вы хотите разместить журналы в другом месте, отличном от стандартного расположения (которое равно backup-dir/datadir). Если значение параметра отличается от backup-dir/datadir, оно сохраняется в файле backup-my.cnf как innodb_log_group_home_dir для информации, чтобы mysqlbackup мог понимать структуру резервной копии при выполнении различных операций с резервной копией. Обратите внимание, что хотя вы можете указать каталог для сохранения журналов, имена файлов журналов фиксированы и не могут быть переконфигурированы с помощью этого параметра.

Значение параметра выводится следующим образом:
- Если backup_innodb_log_group_home_dir не указан, его значение будет backup-dir/datadir.
- Если backup_innodb_log_group_home_dir — абсолютный путь, его значение используется как есть, если он не указывает на расположение, которое находится в backup-dir, но не равно backup-dir/datadir, в этом случае mysqlbackup выдаст ошибку и прервет операцию.
- Если backup_innodb_log_group_home_dir — относительный путь, путь рассматривается как относительный к (то есть, под) backup-dir, и он должен указывать на backup-dir/datadir, в противном случае mysqlbackup выдаст ошибку и прервет операцию.
- Пустая строка (“”) для параметра приводит к ошибке.
Этот параметр применим только для операций резервного копирования; при восстановлении файлы журналов InnoDB восстанавливаются в каталоге данных, указанном в --datadir, если другое расположение не указано с помощью параметра --innodb_log_group_home_dir во время восстановления.
backup_innodb_undo_directory=PATH

Относительный или абсолютный путь к каталогу, где для журналов отката InnoDB во время резервного копирования создаются отдельные табличные пространства. Укажите параметр, если вы хотите разместить журналы отката в месте, отличном от стандартного расположения (которое равно backup_innodb_log_group_home_dir). Если значение параметра отличается от backup-dir/datadir, оно сохраняется в файле backup-my.cnf как innodb_undo_directory для информации, чтобы mysqlbackup мог понимать структуру резервной копии при выполнении различных операций с резервной копией.

Значение параметра определяется следующим образом:
- Если backup_innodb_undo_directory не указан, параметр принимает то же значение, что и backup_innodb_log_group_home_dir.
- Если backup_innodb_undo_directory — абсолютный путь, его значение используется как есть, если он не указывает на расположение, которое находится в backup-dir, но не равно backup-dir/datadir, в этом случае mysqlbackup выдаст ошибку и прервет операцию.
- Если backup_innodb_undo_directory — относительный путь, путь рассматривается как относительный к (то есть, под) backup-dir, и он должен указывать на backup-dir/datadir, в противном случае mysqlbackup выдаст ошибку и прервет операцию.
- Пустая строка (“”) для параметра приводит к ошибке.
Этот параметр применим только для операций резервного копирования; см. описание файлов журналов отката здесь, чтобы узнать, где восстанавливаются журналы отката.
--with-timestamp

Создаёт подкаталог в каталоге резервной копии с именем, сформированным из временной метки операции резервного копирования. Это полезно для поддержания одного каталога резервной копии, содержащего множество снимков резервной копии, помещённых в разные подкаталоги.

По умолчанию подкаталог со временной меткой не создаётся. Чтобы повторно использовать один и тот же каталог резервной копии для новой резервной копии без использования этого параметра, удалите предыдущий образ резервной копии или файлы резервной копии вручную.