Spec-Zone.ru › MySQL Enterprise Backup 4.1

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/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_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/datadir, оно сохраняется в файле backup-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/datadir, оно сохраняется в файле backup-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_group в файле backup-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_size в файле backup-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.
https://docs.oracle.com/cd/E17952_01/mysql-enterprise-backup-4.1-en/backup-repository-options.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API