19.5 Other Single-File Backup Operations — MySQL Enterprise Backup 8.4

19.5 Другие операции резервного копирования одного файла

Помимо команд для создания и восстановления резервных копий одного файла (а именно, backup-to-image и copy-back-and-apply-log), mysqlbackup предоставляет ряд других команд для работы с резервными копиями одного файла. Они описаны ниже.

mysqlbackup [STD-OPTIONS]
            [--backup-image=IMAGE]
            [--backup-dir=PATH]
            [--src-entry=PATH] [--dst-entry=PATH]
            [--uncompress]
            [MESSAGE-LOGGING-OPTIONS]
            [PROGRESS-REPORT-OPTIONS]
            [ENCRYPTION-OPTIONS]
            [CLOUD-STORAGE-OPTIONS]
            image-to-backup-dir

mysqlbackup [STD-OPTIONS]
            [--backup-dir=PATH] [--backup-image=IMAGE]
            [MESSAGE-LOGGING-OPTIONS]
            [PROGRESS-REPORT-OPTIONS]
            [ENCRYPTION-OPTIONS]
            [CLOUD-STORAGE-OPTIONS]
            backup-dir-to-image

mysqlbackup [STD-OPTIONS]
            [--backup-image=IMAGE]
            [MESSAGE-LOGGING-OPTIONS]
            [ENCRYPTION-OPTIONS]
            [CLOUD-STORAGE-OPTIONS]
            list-image

mysqlbackup [STD-OPTIONS]
            [--backup-image=IMAGE]
            [--backup-dir=PATH]
            [--src-entry=PATH] [--dst-entry=PATH]
            [--uncompress]
            [MESSAGE-LOGGING-OPTIONS]
            [PROGRESS-REPORT-OPTIONS]
            [ENCRYPTION-OPTIONS]
            [CLOUD-STORAGE-OPTIONS]
            extract

image-to-backup-dir

Это псевдоним для команды extract; см. описание ниже для extract.

Примечание

image-to-backup-dir создает только директорию, которая НЕ готова к восстановлению с помощью команды copy-back. Чтобы стать готовой к восстановлению, директория резервной копии должна пройти операцию применения журнала, выполненную либо отдельной командой apply-log, либо как часть команды copy-back-and-apply-log.
backup-dir-to-image

Архивирует существующую директорию резервной копии в один файл. Значение параметра --backup-image должно быть либо “-” (обозначает стандартный вывод), либо абсолютный путь вне директории backup-dir. Укажите значение --backup-image как - (стандартный вывод), чтобы передавать структуру существующей директории резервной копии на ленточное устройство или команду, которая передает резервную копию на другой сервер. Примеры использования см. в Разделе 4.3.1, «Создание резервной копии одного файла».
list-image

Отображает содержимое резервной копии одного файла. Выводит список всех файлов и директорий в изображении. Примеры использования см. в Разделе 4.3.1, «Создание резервной копии одного файла».

Примечание

Операция list-image может выполняться на облачной резервной копии только в том случае, если облачный прокси поддерживает HTTP-заголовки диапазона.
extract

Извлекает отдельные файлы или директории из резервной копии одного файла. Это полезно для отладки или для восстановления, не требующего всего набора данных резервной копии. Результирующий файл или директория помещаются в текущую директорию или в , если задано с помощью --backup-dir; в любом случае, целевая директория должна быть пустой. Примеры использования см. в Разделе 4.3.1, «Создание резервной копии одного файла».

Опция --src-entry=string может использоваться для выборочного извлечения файлов или директорий, имена путей которых в изображении содержат string, указанное с помощью этой опции.
Примечания
- Некоторые элементы всегда извлекаются из резервной копии; см. описания --src-entry для получения подробной информации.
- В настоящее время опция не поддерживается для извлечения облачных резервных копий, которые могут извлекаться только целиком.
Совет

Если вы хотите извлечь только из определенных директорий (например, datadir/meta), добавьте косой черты в конце значения опции (--src-entry=meta/); в противном случае, любой файл или директория в резервной копии, содержащая значение в своём имени пути (включая, например, datadir/pets/metabolism.ibd), также будут извлечены.

Опция --dst-entry=path, наряду с --src-entry=path, может использоваться для извлечения файлов или директорий в указанные пользователем места; см. описание опции для получения подробностей.

Используйте опцию --uncompress для извлечения файлов из сжатой резервной копии одного файла (опция --uncompress не требуется когда используется --src-entry).

По умолчанию местом назначения для извлечения является текущая рабочая директория. Все файлы с относительными именами путей в изображении извлекаются в имена путей, относительные к целевой директории. Если изображение содержит некоторые записи с абсолютными именами путей, эти записи извлекаются по тем же абсолютным путям в локальной системе, даже если указана опция --backup-dir. Для перемещения абсолютного имени пути необходимо использовать опцию --dst-entry; см. Пример 4.12, «Обработка абсолютных имён путей».

Важно

Даже при извлечении всех файлов из изображения резервной копии, extract создает только директорию, которая НЕ готова к восстановлению с помощью команды copy-back. Чтобы стать готовой к восстановлению, директория резервной копии должна пройти операцию применения журнала, выполненную либо отдельной командой apply-log, либо как часть команды copy-back-and-apply-log.