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

Загрузка снепшота в Vector DB

примечание

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

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

Загрузка ранее сделанного снепшота в Vector DB.

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

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

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

Инициируйте загрузку снепшота в Vector DB CLI компонента copywala-vdb командой copywala-vdb upload-snapshot, указав все обязательные параметры.

Справка по команде copywala-vdb upload-snapshot

Загрузка определенного снепшот-файла в Vector DB.

Синтаксис:

copywala-vdb upload-snapshot [flags]

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

ФлагОписание
-m|--checksum <path_to_checksum>Путь к файлу c контрольной суммой снепшота
-n|--collection <collection_name>Имя коллекции в БД. Требуется для указания, в какую коллекцию будет загружен снепшот
-s|--snapshot <path_to_snapshot>Путь к снепшот-файлу, который необходимо загрузить

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

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

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

Результат​

В результате успешной загрузки снепшота будет выведено сообщение:

2026-05-13 16:58:34.857 [130848] INF vdb: upload completed

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

Будет выведено соответствующее сообщение для случаев:

примечание

Приведенные ниже сообщения содержат тестовые данные.

  • отсутствия прав на загрузку снепшотов:

    2026-05-15 12:29:46.888 [1785990] ERR failed to upload snapshot err="upload snapshot collection=fcol-copy snapshot=\"/tmp/vdb-restore1/fcol-6655765280948896-2026-05-15-09-23-16.snapshot\": parse error response failed: invalid character 'I' looking for beginning of value: Insufficient permissions for REST API 'POST /collections/fcol-copy/snapshots/upload'"

  • отсутствия файла контрольной суммы снепшота:

    2026-05-15 12:21:19.150 [1780985] ERR read checksum from file err="open /tmp/vdb-restore1/fcol-6655765280948896-2026-04-21-14-17-17.snapshot.checksum: no such file or directory"

  • ошибки подключения к Vector DB:

    2026-05-15 12:20:41.444 [1780174] ERR create vdb client failed err="auth: Post \"https://127.0.0.1:6333/auth\": dial tcp 127.0.0.1:6333: connect: connection refused"

  • ошибки сверки контрольных сумм снепшотов:

    2026-05-15 12:34:44.055 [1787757] ERR failed to upload snapshot err="upload snapshot collection=fcol-copy snapshot=\"/tmp/vdb-restore1/fcol-6655765280948896-2026-05-15-09-23-16.snapshot\": send request: Checksum mismatch: expected {example_hash_1}, actual {example_hash_2}"