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

Источник: https://modelium.tech/zhurnal/qdrant-proverit-sushchestvovanie-kollekcii/

Перед загрузкой точек в 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](#src-s1) [s3](#src-s3) [s4](#src-s4)

## Зачем проверять имя до записи?

Вы подготовили коллекцию `demo_notes`, но не помните, создали ли её. **Коллекция** — место, где Qdrant хранит записи с векторами для поиска. Проверка существования — запрос на чтение: она не создаёт коллекцию, не записывает точки и не подтверждает совместимость её параметров с вашей моделью. [s1](#src-s1) [s2](#src-s2)

## Как проверить коллекцию и её параметры?

Сначала [запустите свой локальный Qdrant](/zhurnal/qdrant-lokalno/) и откройте терминал на том же компьютере. Здесь `demo_notes` — **пример имени**, не подставляйте рабочую коллекцию в инструкции на запись без отдельной проверки. [s3](#src-s3)

- Выполните `curl -fsS 'http://127.0.0.1:6333/collections/demo_notes/exists'`. При существующей коллекции ожидайте JSON со `status: "ok"` и `result: {"exists": true}`; если такой коллекции нет — `result: {"exists": false}`. Это два ожидаемых варианта из документации, **не результаты запуска редакции**. [s1](#src-s1)

- **Только если получили **`**true**`, выполните `curl -fsS 'http://127.0.0.1:6333/collections/demo_notes'`. В `result.config.params.vectors` проверьте тип/размерность вектора и метрику своего проекта; значение в примере ответа официального API не обязано совпадать с настройками вашей коллекции. Само `true` не доказывает, что в ней есть записи или что параметры подходят будущим векторам. [s2](#src-s2)

Если получили `false`, не отправляйте записи в отсутствующую коллекцию: начните с [гайда по локальному запуску Qdrant](/zhurnal/qdrant-lokalno/) и создайте **отдельную** коллекцию с параметрами под свои векторы. Если нужен следующий шаг для уже подготовленной коллекции, [прочитайте учебную точку по ID](/zhurnal/qdrant-get-point-by-id/). [s2](#src-s2) [s3](#src-s3)

## Что означает ошибка вместо true или false?

`curl` сообщает о недоступности адреса или HTTP-ошибке отдельно от логического `false`: проверьте, что сервер запущен на том же компьютере и нужном порту. При включённой защите используйте разрешённую вам схему доступа из документации Qdrant — не вставляйте секрет в общедоступную команду, URL или снимок экрана. Не открывайте тестовый сервер в интернет ради прохождения примера. Проверка существования не заменяет проверку прав доступа и не сообщает [число точек](/zhurnal/qdrant-count-points/). [s1](#src-s1) [s3](#src-s3) [s4](#src-s4)

## Источники

1. [Qdrant API v1.19.x — Check collection existence](https://api.qdrant.tech/v-1-19-x/api-reference/collections/collection-exists.md) — получено 2026-10-19
2. [Qdrant API v1.19.x — Get collection details](https://api.qdrant.tech/v-1-19-x/api-reference/collections/get-collection.md) — получено 2026-10-19
3. [Qdrant — Quickstart](https://qdrant.tech/documentation/quickstart/) — получено 2026-10-19
4. [Qdrant — Security](https://qdrant.tech/documentation/security/) — получено 2026-10-19