Режим восстановления#

Данный инструмент администрирования позволяют изменять поведение экземпляра Platform V Vector DB (далее - Vector DB) во время выполнения без необходимости ручного редактирования его конфигурации.

Режим восстановления используется, когда экземпляр Vector DB не может запускаться из-за проблем с памятью (например, при попытке загрузить все данные в RAM). В этом режиме сервер загружает только метаданные коллекций, что позволяет выполнять ограниченный набор операций (например, удаление коллекции) для устранения проблем.

Цель: позволить администратору устранить причины ошибки (например, удалить перегруженную коллекцию) и избежать полной загрузки данных, которая может привести к сбою из-за нехватки памяти.

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

Пререквизиты:

  • Доступ к серверу: SSH или физический доступ.

  • Установленный продукт: сервер должен быть запущен (кроме операций с файлами данных).

  • Исходный код: скрипты находятся в /src/bin/ репозитория продукта.

  • Rust: установленный компилятор для сборки утилит.

Привилегии:

  • Файловая система: права на чтение/запись в storage_path.

  • API-ключ: обязателен ключ с правами admin для большинства операций.

  • Сетевой доступ: доступность API-порта (порт по умолчанию 6333).

Ключевые требования:

  • Vector DB остановлен.

  • Полный доступ к данным на диске.

  • Резервная копия.

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

  1. Активация режима восстановления.

    Запустите экземпляр Vector DB с переменной окружения QDRANT__STORAGE__RECOVERY_MODE, указав произвольное сообщение:

    export QDRANT__STORAGE__RECOVERY_MODE="Fixing memory issue"
./qdrant

  2. Выполнение операций в режиме восстановления.

    В текущем режиме доступны только удаление коллекции:

    client.delete_collection(collection_name="{collection_name}")

  3. Перезапуск в обычном режиме.

    После устранения проблемы перезапустите сервер без переменной QDRANT__STORAGE__RECOVERY_MODE.

Результат#

Действие

Результат

Загрузка метаданных

Сервер загружает только структуру коллекций, минуя данные и индексы

Операции в режиме

Возможность удалить проблемные коллекции, освобождая ресурсы

Устранение ошибки

После удаления коллекции можно перезапустить сервер в обычном режиме

Ограничения

Недоступны добавление/изменение данных или создание новых коллекций

  • Использование только для исправления проблем: режим восстановления не предназначен для регулярного использования.

  • Точность сообщения: сообщение в переменной окружения отображается в логах, но не влияет на поведение системы.

  • Проверка логов: убедитесь, что сервер действительно работает в режиме восстановления (смотрите логи при старте).