Просмотр дополнительных файлов, находящихся в резервной копии
Исполнять сценарий необходимо от имени пользователя postgres.
Описание сценария
Просмотр списка дополнительных файлов, включенных в CWL-архив резервной копии, а также содержимого конкретного файла.
Предусловие
- Создана резервная копия с включенными дополнительными файлами (подробнее – в разделе Добавление дополнительных файлов в резервную копию).
- CWL-архив доступен для чтения.
Просмотр списка дополнительных файлов
Инициируйте просмотр списка дополнительных файлов через CLI copywala командой copywala cwl extra-files list (ознакомьтесь со справкой по команде ниже).
Справка по команде copywala cwl extra-files list
Описание:
Выводит список всех дополнительных файлов, содержащихся в CWL-архиве резервной копии, с их метаданными (путь, размер, права доступа, время последнего изменения).
Синтаксис:
copywala cwl extra-files list <path to cwl archive> [flags]
Обязательные параметры:
<path to cwl archive> – путь к CWL-архиву резервной копии.
Если в команде используется URI, указывающий подключение к DDBoost через S2, его необходимо обязательно заключать в двойные кавычки.
Это требование связано с тем, что URI содержит символ &, который интерпретируется Bash как оператор фонового запуска команды.
Ниже приведен пример для команды copywala cwl info:
copywala cwl info "s2://<s2-host>/<ddboost-storage-unit>/path/in/ddboost/storage/unit?driver=ddboost&data_domain_host=<ddboost-host>"
Опциональные параметры:
[flags] – доступны следующие флаги:
| Флаг | Описание |
|---|---|
-h|--help | Показать справку по команде |
-c|--config <path to copywala config> | Использовать конфигурационный файл, отличный от файла по умолчанию: /etc/pbr/copywala.yaml |
--short | Вывести только пути к файлам без таблицы |
В результате выполнения команды будет выведена таблица со списком дополнительных файлов и их метаданными:
:caption: Пример
$ copywala cwl extra-files list /home/postgres/backups/test_06_07_019f3625-4480-77d8-ad10-f2980111eeb8/backups/2026-07-07-11-25_019f3bae-f23e-7425-b7ac-1714f788dbbe_full_000000010000000000000039.cwl
+---+-------------------------------------+----------+-------+---------------------+
| # | EXTRA FILE PATH | SIZE | MODE | LAST MODIFIED |
+---+-------------------------------------+----------+-------+---------------------+
| 1 | /etc/pbr/test_file_1.conf | 500.00KB | 0o640 | 2026-07-07 11:25:26 |
| 2 | /etc/pbr/test_file_2.conf | 5.00MB | 0o640 | 2026-07-07 11:25:44 |
+---+-------------------------------------+----------+-------+---------------------+
| Поле | Описание |
|---|---|
# | Порядковый номер файла в списке |
EXTRA FILE PATH | Исходный полный путь к файлу на сервере |
SIZE | Размер файла |
MODE | Права доступа к файлу |
LAST MODIFIED | Дата и время последнего изменения файла |
Если в архиве отсутствуют дополнительные файлы, будет выведено сообщение:
No extra files in archive
:caption: Пример с использованием флага `--short`
$ copywala cwl extra-files list /home/postgres/backups/test_06_07_019f3625-4480-77d8-ad10-f2980111eeb8/backups/2026-07-07-11-25_019f3bae-f23e-7425-b7ac-1714f788dbbe_full_000000010000000000000039.cwl --short
/etc/pbr/test_file_1.conf
/etc/pbr/test_file_2.conf
Просмотр содержимого файла
Для просмотра содержимого конкретного дополнительного файла выполните команду copywala cwl extra-files view (ознакомьтесь со справкой по команде ниже).
Справка по команде copywala cwl extra-files view
Описание:
Позволяет просмотреть содержимое указанного дополнительного файла из CWL-архива резервной копии.
Синтаксис:
copywala cwl extra-files view <path to cwl archive> --file <original path> [flags]
Обязательные параметры:
| Флаг / Параметр | Описание |
|---|---|
<path to cwl archive> | Путь к CWL-архиву резервной копии |
-f|--file <original path> | Исходный путь к файлу в архиве (такой, как он был указан при создании резервной копии в параметре extra_files файла copywala.yaml) |
Если в команде используется URI, указывающий подключение к DDBoost через S2, его необходимо обязательно заключать в двойные кавычки.
Это требование связано с тем, что URI содержит символ &, который интерпретируется Bash как оператор фонового запуска команды.
Ниже приведен пример для команды copywala cwl info:
copywala cwl info "s2://<s2-host>/<ddboost-storage-unit>/path/in/ddboost/storage/unit?driver=ddboost&data_domain_host=<ddboost-host>"
Опциональные параметры:
[flags] – доступны следующие флаги:
| Флаг | Описание |
|---|---|
-h|--help | Показать справку по команде |
-c|--config <path to copywala config> | Использовать конфигурационный файл, отличный от файла по умолчанию: /etc/pbr/copywala.yaml |
В результате выполнения команды будет выведено содержимое необходимого файла:
:caption: Пример
$ copywala cwl extra-files view /home/postgres/backups/test_06_07_019f3625-4480-77d8-ad10-f2980111eeb8/backups/2026-07-07-11-45_019f3bc1-0a97-7110-92c9-48fe7b8f6a24_full_00000001000000000000003D.cwl \
--file /etc/pbr/test_file_1.conf
# Example application configuration
[server]
host=127.0.0.1
port=8080
timeout=30
debug=true
[user]
name=admin
role=administrator
email=admin@example.com
Исключительные сценарии
Будет выведено соответствующее сообщение для случаев:
-
Отсутствуют права на чтение CWL-архива.
-
Указан неверный путь к CWL-архиву.
-
CWL-архив поврежден.
-
Указанный файл отсутствует в CWL-архиве:
:caption: Пример вывода
ERR failed to read extra file file=/etc/pbr/test_file_6.conf err="extra file not found: /etc/pbr/test_file_6.conf"