Qdrant: проверить, существует ли коллекция
На странице · 3 разделов
Перед загрузкой точек в Qdrant проверьте имя коллекции: запрос `/exists` возвращает `result.exists: true` или `false`. Если она есть, отдельным запросом прочитайте её параметры, а не предполагайте, что они подходят вашей модели. Это техническая инструкция для уже работающего локального сервера; редакция не запускала Qdrant.
Технический уровень. Нужен уже работающий Qdrant v1.19.x на своём компьютере и терминал Linux/macOS с
curl. Это не рецепт установки AI-модели. Шаги сверены по документации 19 октября 2026 года, но редакция Qdrant не запускала. Используйте только адрес127.0.0.1; обычный тестовый сервер Qdrant по умолчанию не защищён паролем, а на сервере с API-ключом показанные запросы без авторизации не пройдут. s1 s3 s4
Зачем проверять имя до записи?
Вы подготовили коллекцию demo_notes, но не помните, создали ли её. Коллекция — место, где Qdrant хранит записи с векторами для поиска. Проверка существования — запрос на чтение: она не создаёт коллекцию, не записывает точки и не подтверждает совместимость её параметров с вашей моделью. s1 s2
Как проверить коллекцию и её параметры?
Сначала запустите свой локальный Qdrant и откройте терминал на том же компьютере. Здесь demo_notes — пример имени, не подставляйте рабочую коллекцию в инструкции на запись без отдельной проверки. s3
- Выполните
curl -fsS 'http://127.0.0.1:6333/collections/demo_notes/exists'. При существующей коллекции ожидайте JSON соstatus: "ok"иresult: {"exists": true}; если такой коллекции нет —result: {"exists": false}. Это два ожидаемых варианта из документации, не результаты запуска редакции. s1 - Только если получили
true, выполнитеcurl -fsS 'http://127.0.0.1:6333/collections/demo_notes'. Вresult.config.params.vectorsпроверьте тип/размерность вектора и метрику своего проекта; значение в примере ответа официального API не обязано совпадать с настройками вашей коллекции. Самоtrueне доказывает, что в ней есть записи или что параметры подходят будущим векторам. s2
Если получили false, не отправляйте записи в отсутствующую коллекцию: начните с гайда по локальному запуску Qdrant и создайте отдельную коллекцию с параметрами под свои векторы. Если нужен следующий шаг для уже подготовленной коллекции, прочитайте учебную точку по ID. s2 s3
Что означает ошибка вместо true или false?
curl сообщает о недоступности адреса или HTTP-ошибке отдельно от логического false: проверьте, что сервер запущен на том же компьютере и нужном порту. При включённой защите используйте разрешённую вам схему доступа из документации Qdrant — не вставляйте секрет в общедоступную команду, URL или снимок экрана. Не открывайте тестовый сервер в интернет ради прохождения примера. Проверка существования не заменяет проверку прав доступа и не сообщает число точек. s1 s3 s4
Источники
- Qdrant API v1.19.x — Check collection existence. Получено 19.10.2026.
- Qdrant API v1.19.x — Get collection details. Получено 19.10.2026.
- Qdrant — Quickstart. Получено 19.10.2026.
- Qdrant — Security. Получено 19.10.2026.