16.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И для версии 4.1.5 и более поздних версий, mysqlbackup использует значение--backup-imageкак путь, относительный к текущей рабочей директории, в которой выполняется команда mysqlbackup.ПримечаниеДля версии 4.1.4 и более ранних версий: Относительный путь, указанный для
--backup-image, рассматривается как относительный к для вышеупомянутых операций.
По умолчанию резервная копия одного файла передается в стандартный вывод, так что вы можете передать ее напрямую другим командам, таким как резервное копирование на ленту или сетевой команде, связанной с 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/datadirbackup-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_innodb_data_home_dir— это относительный путь, путь считается относительным к (т. е., под)backup-dir.Пустая строка (“”) для
backup_innodb_data_home_dirозначает, что значениеinnodb_data_file_pathдолжно рассматриваться как абсолютный путь.
Этот параметр применим только для операций резервного копирования; при восстановлении файлы данных InnoDB восстанавливаются в каталоге данных, указанном опцией
--datadir, если при восстановлении не указано другое местоположение с помощью опции--innodb_data_home_dir. -
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на""[пустая строка], кроме того, следует использовать абсолютный путь для этой опции.Если параметр не указан, он наследует значение опции
innodb_data_file_pathна сервере резервной копии. Если исходный и целевой объекты резервной копии пытаются использовать одни и те же абсолютные пути, которые указывают на одни и те же файлы, резервное копирование отменяется.Значение параметра сохраняется в файле
backup-my.cnfкакinnodb_data_file_pathдля информации, чтобы mysqlbackup мог понимать структуру резервной копии при выполнении различных операций с ней. -
backup_innodb_log_group_home_dir=PATHКаталог, в котором будут храниться журналы InnoDB резервной копии. Укажите эту опцию только в том случае, если вы хотите разместить журналы в другом месте, отличном от стандартного местоположения (
). Если значение параметра отличается отbackup-dir/datadir, оно сохраняется в файлеbackup-dir/datadirbackup-my.cnfкакinnodb_log_group_home_dirдля информации, чтобы mysqlbackup мог понимать структуру резервной копии при выполнении различных операций с ней. Обратите внимание, что, хотя вы можете указать каталог для сохранения журналов, имена файлов журналов фиксированы и не настраиваются.Этот параметр применим только для операций резервного копирования; при восстановлении файлы журналов InnoDB восстанавливаются в каталоге данных, указанном опцией
--datadir, если при восстановлении не указано другое местоположение с помощью опции--innodb_log_group_home_dir. Значение параметра вычисляется следующим образом:Если
backup_innodb_log_group_home_dirне указан, его значение будет.backup-dir/datadirЕсли
backup_innodb_log_group_home_dir— это абсолютный путь, его значение используется как есть.Если
backup_innodb_log_group_home_dir— это относительный путь, путь считается относительным к (т. е., под)backup-dir.Пустая строка (“”) для этой опции приводит к ошибке.
-
backup_innodb_undo_directory=PATHОтносительный или абсолютный путь к каталогу, где создаются отдельные табличные пространства для журналов отката InnoDB во время резервного копирования. Если не указан, опция принимает то же значение, что и
backup_innodb_log_group_home_dir; укажите эту опцию только в том случае, если вы хотите разместить журналы отката в другом месте. Если значение параметра отличается от, оно сохраняется в файлеbackup-dir/datadirbackup-my.cnfкакinnodb_undo_directoryдля информации, чтобы mysqlbackup мог понимать структуру резервной копии при выполнении различных операций с ней.Этот параметр применим только для операций резервного копирования; при восстановлении табличные пространства журналов отката InnoDB восстанавливаются в каталоге данных, указанном с помощью
--datadir, если при восстановлении не указано другое местоположение с помощью опции--innodb_undo_directory.
-
--with-timestampСоздаёт подкаталог в каталоге резервной копии с именем, сформированным из временной метки операции резервного копирования. Это полезно для поддержания одного каталога резервных копий, содержащего много снимков резервных копий, помещённых в разные подкаталоги.
По умолчанию подкаталог с временной меткой не создаётся. Чтобы повторно использовать тот же каталог резервной копии для новой резервной копии без использования этого параметра, необходимо либо вручную удалить предыдущие файлы резервной копии, либо, для резервной копии одного файла, указать параметр
--forceдля перезаписи старого файла резервной копии.
Следующие параметры предоставляют информацию об исходной структуре данных на сервере, с которого выполняется резервное копирование, для будущих операций с резервной копией, но не влияют на структуру самой резервной копии:
-
backup_innodb_log_files_in_group=NКоличество файлов журнала InnoDB в группе журналов на восстанавливаемом сервере. Смотрите описание в руководстве по серверу MySQL. Значение этого параметра, сохранённое как
в файлеinnodb_log_files_in_groupbackup-my.cnf, вычисляется следующим образом:Используется значение
backup_innodb_log_files_in_groupиз командной строки или файла конфигурации, если указано.В противном случае используется значение с сервера, с которого выполнялась резервная копия, если это онлайн-резервная копия.
В противном случае используется значение
innodb_log_files_in_groupиз командной строки или файла конфигурации команды mysqlbackup.
-
backup_innodb_log_file_size=SIZEМаксимальный размер файла журнала InnoDB в резервной копии перед переключением на следующий файл журнала на восстанавливаемом сервере. Смотрите описание в руководстве по серверу MySQL. Значение этого параметра, сохранённое как
в файлеinnodb_log_file_sizebackup-my.cnf, вычисляется следующим образом:Используется значение
backup_innodb_log_file_sizeиз командной строки или файла конфигурации, если указано.В противном случае используется значение с сервера, с которого выполнялась резервная копия, если это онлайн-резервная копия.
В противном случае используется указанное значение
innodb_log_file_sizeиз командной строки или файла конфигурации команды mysqlbackup.
-
backup_innodb_page_size=SIZEУказывает размер страницы для всех табличных пространств InnoDB на восстанавливаемом сервере для офлайн резервной копии. Этот параметр следует указывать осторожно, так как размер страницы должен совпадать с размером страницы на резервируемом экземпляре MySQL, иначе резервная копия может стать бесполезной. Для онлайн-резервной копии значение берётся из значения параметра на сервере, с которого выполнялась резервная копия.
Значение этого параметра сохраняется в файле
backup-my.cnfдля использования при восстановлении базы данных. -
backup_innodb_undo_logs=NUMBERУказывает количество сегментов отката в табличном пространстве системы InnoDB на восстанавливаемом сервере для офлайн резервной копии. Этот параметр следует указывать осторожно, так как значение должно совпадать со значением на резервируемом экземпляре MySQL, иначе резервная копия может стать бесполезной. Для онлайн-резервной копии значение параметра берётся из значения параметра на сервере, с которого выполнялась резервная копия.
-
backup_innodb_undo_tablespaces=NUMBERУказывает количество файлов табличного пространства, между которыми разделены журналы отката, когда используется ненулевое значение параметра
backup_innodb_undo_logs. Этот параметр следует указывать осторожно, так как значение должно совпадать со значением на резервируемом экземпляре MySQL, иначе резервная копия может стать бесполезной. Для онлайн-резервной копии значение параметра берётся из значения параметра на сервере, с которого выполнялась резервная копия. По умолчанию все журналы отката являются частью табличного пространства системы, и табличное пространство системы всегда содержит одно табличное пространство отката в дополнение к тем, которые настраиваются параметром innodb_undo_tablespaces. -
backup_innodb_checksum_algorithm=NAMEУказывает имя алгоритма проверки контрольных сумм, используемого для проверки табличных пространств InnoDB на восстанавливаемом сервере для офлайн резервной копии. Этот параметр следует указывать осторожно, так как алгоритм контрольной суммы должен совпадать с алгоритмом на резервируемом экземпляре MySQL, иначе резервная копия может стать бесполезной. Для онлайн-резервной копии значение берётся из значения параметра
innodb_checksum_algorithmна сервере, с которого выполнялась резервная копия.Значение параметра по умолчанию равно “innodb”.
Значение этого параметра сохраняется в файле
backup-my.cnfдля использования при восстановлении базы данных.
© 2025 Oracle
Licensed under the GPLv2 License.