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

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

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

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

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

Если тестового сервера ещё нет, сначала откройте гайд по локальному Qdrant. Используйте только новую учебную коллекцию: если 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

Загрузите три искусственные точки: 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

Посчитайте все точки: 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 s4

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

Для небольшого набора прочитайте сами ID через Scroll: должны быть 1, 2 и 3, а поле kind: letter — только у 1 и 2. Count возвращает число, а не сами записи; Scroll нужен для просмотра состава. Если нужен список точек из большой коллекции, не принимайте первую страницу Scroll за полный набор. s1 s4

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