Qdrant – векторная база данных и поисковый движок с открытым исходным кодом, созданные для хранения эмбеддингов (численных представлений текста, изображений, аудио и т. п.) и поиска наиболее близких совпадений по значению, а не просто по ключевым словам.
На практике создание векторной базы данных Qdrant позволяет ИИ-приложениям выполнять быструю генерацию семантического поиска и рекомендаций за счет индексации обычных данных в многомерные векторы ANN-алгоритмами.
Qdrant хранит данные в формате коллекций – именованных групп точек. Под точкой подразумевается вектор (эмбеддинг) в комбинации с опциональными ID и метаданными в формате JSON.
Для хранения предоставляется 2 опции:
- Хранение в памяти – обеспечивает наибольшую производительность, векторы хранятся в памяти с записью на диск в фоне.
- Memmap – использует маппинг памяти к файлу на диске, предлагая баланс производительности и эффективности хранения данных.
Для Qdrant существуют готовые официальные клиентские библиотеки для:
Если выбранного вами языка нет в списке, вы также можете сгенерировать клиент на основе спецификации OpenAPI или protobuf.
Qdrant от Beget – готовая к работе платформа для хранения и поиска векторных данных, развернутая на вашем виртуальном сервере с SSL-сертификатом на выбранном домене.
Состав приложения
- Ubuntu
- Docker
- Qdrant
Установка Qdrant
При создании сервера помимо стандартных параметров будет предложено указать:
- Домен – вы можете указать как собственный домен для использования с Qdrant, так и воспользоваться бесплатным техническим доменом в зоне .beget.app.
- Email администратора – используется для выпуска сертификата TLS.
- API-ключ – используется для авторизации запросов к Qdrant. По умолчанию автоматически генерируется случайный ключ.
Начало работы с Qdrant
Для начала работы с Qdrant перейдите по адресу https://my-domain.beget.app:6333/dashboard, где my-domain.beget.app – выбранный вами в процессе установки домен. Откроется страница авторизации:
Для входа в панель управления введите в предложенном поле API-ключ, указанный при установке. Он также будет указан в соответствующем поле в разделе “Информация о Qdrant” в панели управления. После успешной авторизации откроется дашборд Qdrant:
Дополнительная настройка после установки не требуется – сервис готов к работе сразу после разворачивания. Если вы еще не работали с Qdrant, нажмите Quickstart для запуска встроенного туториала. Описание работы с API доступно в соответствующем разделе на официальном сайте, а подробная документация решения – по ссылке.
FAQ
Qdrant установлен в виде контейнера Docker, файл docker-compose.yml, конфигурационные файлы config.yaml и .env расположены в директории /opt/beget/qdrant. Здесь же директории storage и snapshots для хранения данных приложения.
При установке автоматически разворачивается последняя версия Qdrant. Для обновления перейдите в директорию приложения командой cd /opt/beget/qdrant, после чего загрузите последнюю версию контейнера командой docker compose pull и пересоздайте контейнер, последовательно выполнив docker compose down и docker compose up -d.
В случае если ключ API был скомпрометирован, его необходимо изменить для предотвращения несанкционированного доступа к сервису. Для этого подключитесь к серверу по SSH, после чего перейдите в директорию приложения командой cd /opt/beget/qdrant и откройте файл .env удобным вам текстовым редактором – например, vim. Затем измените значение переменной QDRANT_API_KEY на новый случайный ключ и сохраните изменения, а после этого – пересоздайте контейнер командами docker compose down и docker compose up -d.
Для подключения Qdrant к n8n установите официальную ноду Qdrant в редакторе workflow:
Добавьте желаемое действие в workflow, а затем в меню настройки создайте новый credentials:
В появившемся меню укажите ключ api и адрес сервера Qdrant, указанные при установке:
