Перейти к содержанию
modelium.
Начать с задачи
←

Qdrant: проверить, существует ли коллекция

Перед загрузкой точек в 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

  1. Выполните curl -fsS 'http://127.0.0.1:6333/collections/demo_notes/exists'. При существующей коллекции ожидайте JSON со status: "ok" и result: {"exists": true}; если такой коллекции нет — result: {"exists": false}. Это два ожидаемых варианта из документации, не результаты запуска редакции. s1
  2. Только если получили 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

Источники

  1. Qdrant API v1.19.x — Check collection existence. Получено 19.10.2026.
  2. Qdrant API v1.19.x — Get collection details. Получено 19.10.2026.
  3. Qdrant — Quickstart. Получено 19.10.2026.
  4. Qdrant — Security. Получено 19.10.2026.