# Qdrant Count: как узнать число точек коллекции и записей с фильтром

Источник: https://modelium.tech/zhurnal/qdrant-count-points/

Для точного количества записей в коллекции Qdrant отправьте запрос Count points с exact: true. Условие filter позволяет посчитать только записи с нужным значением поля. Ниже — безопасный пример на новой учебной коллекции; настоящий сервер редакция не запускала.

**Технический уровень.** Нужны собственный Qdrant и терминал Linux или macOS с `curl`; это не установка AI-модели на домашний компьютер. Инструкция сверена с официальным API v1.19.x 19 октября 2026 года, но редакция не запускала настоящий Qdrant: числа ниже — **ожидаемый результат для искусственного набора**, не наш замер. Пример обращается только к `127.0.0.1`. Если ваш сервер требует API-ключ, используйте защищённый доступ, не вставляя секрет в открытые команды. [s1](#src-s1) [s3](#src-s3)

## Что именно считает Qdrant?

**Точка** — запись коллекции с ID, вектором и, при необходимости, дополнительными полями (*payload*). Если коллекция хранит три учебные записи, Count points с `exact: true` должен вернуть `result.count: 3`. Фильтр (*filter*) сузит подсчёт: например, до двух записей, у которых поле `kind` равно `letter`. Запрос чтения ничего не удаляет и не считает число слов в документах. [s1](#src-s1)

Не путайте Count points с полем `points_count` при просмотре сведений о коллекции: Qdrant описывает последнее как **приблизительное**. `indexed_vectors_count` тоже не равно гарантированному числу записей. Если вам нужно проверять точное количество после загрузки, используйте Count points с явным `exact: true`. [s1](#src-s1) [s2](#src-s2)

## Как посчитать записи на маленьком примере?

Если тестового сервера ещё нет, сначала откройте [гайд по локальному Qdrant](/zhurnal/qdrant-lokalno/). Используйте только **новую учебную коллекцию**: если `demo_count_20261019` уже существует, выберите другое неиспользованное имя и одинаково замените его во всех командах. Сначала создайте коллекцию с двухчисловыми учебными векторами: `curl -fsS -X PUT 'http://127.0.0.1:6333/collections/demo_count_20261019' -H 'Content-Type: application/json' -d '{"vectors":{"size":2,"distance":"Cosine"}}'`. Ожидайте `status: ok` и `result: true`; при ошибке остановитесь. Размерность `2` — только для этого примера, не рекомендация для реальных документов. [s3](#src-s3)

Загрузите три искусственные точки: `curl -fsS -X PUT 'http://127.0.0.1:6333/collections/demo_count_20261019/points?wait=true' -H 'Content-Type: application/json' -d '{"points":[{"id":1,"vector":[1,0],"payload":{"kind":"letter"}},{"id":2,"vector":[0,1],"payload":{"kind":"letter"}},{"id":3,"vector":[1,1],"payload":{"kind":"note"}}]}'`. Ожидайте `status: ok` и `result.status: completed`. **Upsert может заменить точку с уже существующим ID** — никогда не подставляйте вместо учебной коллекции рабочую. Эти числа не получены от модели. [s4](#src-s4)

Посчитайте все точки: `curl -fsS -X POST 'http://127.0.0.1:6333/collections/demo_count_20261019/points/count' -H 'Content-Type: application/json' -d '{"exact":true}'`. В неизменённом учебном наборе ожидайте `status: ok` и `result.count: 3`. Затем посчитайте только `kind: letter`: `curl -fsS -X POST 'http://127.0.0.1:6333/collections/demo_count_20261019/points/count' -H 'Content-Type: application/json' -d '{"exact":true,"filter":{"must":[{"key":"kind","match":{"value":"letter"}}]}}'`. Ожидаемый `result.count: 2`. Если показаны другие числа, не объявляйте загрузку успешной: проверьте имя коллекции, ответ Upsert, значение поля и параллельные изменения. [s1](#src-s1) [s4](#src-s4)

## Как проверить результат и где предел метода?

Для небольшого набора [прочитайте сами ID через Scroll](/zhurnal/qdrant-scroll-vse-tochki/): должны быть 1, 2 и 3, а поле `kind: letter` — только у 1 и 2. Count возвращает **число**, а не сами записи; Scroll нужен для просмотра состава. Если нужен список точек из большой коллекции, не принимайте первую страницу Scroll за полный набор. [s1](#src-s1) [s4](#src-s4)

Ошибка соединения означает, что локальный сервер не отвечает на `127.0.0.1:6333`; проверьте запуск и адрес, но не открывайте Qdrant в интернет ради примера. При отказе в доступе обратитесь к своей настройке ключа. Разные версии сервера и одновременная запись могут изменить наблюдаемые ответы; документация v1.19.x и синтаксическая проверка команд **не являются** проверкой на вашем сервере. Здесь нет AI-модели, проверки качества поиска или замера скорости. [s1](#src-s1) [s2](#src-s2)

## Источники

1. [Qdrant — Count points, API v1.19.x](https://api.qdrant.tech/v-1-19-x/api-reference/points/count-points.md) — получено 2026-10-19
2. [Qdrant — Get collection, API v1.19.x](https://api.qdrant.tech/v-1-19-x/api-reference/collections/get-collection.md) — получено 2026-10-19
3. [Qdrant — Create collection, API v1.19.x](https://api.qdrant.tech/v-1-19-x/api-reference/collections/create-collection.md) — получено 2026-10-19
4. [Qdrant — Upsert points, API v1.19.x](https://api.qdrant.tech/v-1-19-x/api-reference/points/upsert-points.md) — получено 2026-10-19