Перейти к основному содержимому

Распаковка CWL-архива со снепшот-файлами в заданную директорию

примечание

Исполнять сценарий необходимо от имени пользователя qdrant.

Описание сценария​

Выполнение распаковки CWL-архива, который содержит снепшоты (снепшот), в заданную директорию.

Предусловия​

  1. Архив со снепшотами существует и доступен. Проверьте, выполнив команду copywala-vdb storage backups <instance-name> (ознакомьтесь со справкой по команде ниже).

    Справка по команде copywala-vdb storage backups

    Описание:

    Выводит список существующих резервных копий текущего экземпляра или другого необходимого экземпляра.

    Синтаксис:

    copywala-vdb storage backups <instance-name> [flags]

    Обязательные параметры:

    Нет.

    Опциональные параметры:

    • [instance-name] – уникальное имя агента.

    • [flags] – доступны следующие флаги:

      ФлагОписание
      -h|--helpПоказать справку по команде
      -c|--config <path to copywala-vdb config>Использовать конфигурационный файл, отличный от файла по умолчанию: /etc/pbr/copywala-vdb.yaml
      -u|--destination-uri <path to backups>Путь до хранилища резервных копий. Если параметр не указан, используется значение из конфигурационного файла copywala-vdb.yaml параметр backup_destination_uri

  2. В конфигурационном файле copywala-vdb.yaml заданы значения для параметров:

    • restore_instance_name – наименование экземпляра БД для распаковки (соответствует уникальному имени экземпляра агента — instance_name, полученному при инициализации приложения).
    • restore_data_path – есть возможность переопределить при вызове команды распаковки с помощью флага --destination <path_to_destination>.

Последовательность выполнения​

Выполните команду:

copywala-vdb restore <archive uri or path>
Справка по команде copywala-vdb restore

Описание:

Распаковка CWL-архива со снепшот-файлами в заданную директорию.

Синтаксис:

copywala-vdb restore <archive uri or path> [flags]

Обязательные параметры:

<archive uri or path> – путь к CWL-архиву со снепшотом / снепшотами из которых требуется восстановить данные.

Опциональные параметры:

[flags] – доступны следующие флаги:

ФлагОписание
-h|--helpПоказать справку по команде
-c|--config <path to copywala-vdb config>Использовать конфигурационный файл, отличный от файла по умолчанию: /etc/pbr/copywala-vdb.yaml
--destination <path_to_destination>Путь к директории, в которую необходимо произвести восстановление. Если данный флаг не задан, архив со снепшотами будет распакован в директорию, указанную в конфигурационном файле copywala.yaml параметре restore_data_path
--cpuprofile <path_to_file>Включает сбор профиля использования CPU и сохраняет результаты в указанный файл (<path to file>) для последующего анализа производительности

Результат​

Распакованные из архива снепшот-файлы находятся в указанной директории.

В лог будет выведена информация с описанием события:

$ copywala-vdb restore backups/db... --destination=vdb_restored
[...] INF restore source uri: ...
[...] INF restore destination uri: ...
[...] finished reading parts package=cwl
[...] vdb: restore completed

$ ls vdb_restored
fcol...snapshot fcol...snapshot.checksum ...

Исключительные сценарии​

Для исключительных сценариев в лог будет выведена информация с описанием событий:

  • Отсутствие архива

    $ copywala-vdb restore not-exists.cwl
    [...] ERR failed to init restore components err="open .../not-exists.cwl: no such file or directory"

  • Выбор неподдерживаемого типа архива

    $ copywala-vdb restore archive.bad
    [...] ERR failed to init restore components err="unsupported archive extension"