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

Qdrant: получить точку по ID

На странице · 3 разделов

Если ID точки уже известен, Qdrant позволяет запросить её напрямую, не обходя всю коллекцию через Scroll. Ниже — учебный пример для собственного локального сервера: записать две искусственные точки и получить одну по ID. Действия сверены с API v1.19.x, но редакция не запускала Qdrant; на сервере с ключом понадобится авторизация.

Технический уровень. Нужен уже установленный Qdrant v1.19.x на собственном компьютере и терминал Linux/macOS с curl. Это не рецепт установки AI-модели. Инструкция сверена по документации 19 октября 2026 года; редакция не запускала Qdrant. Команды направлены только на 127.0.0.1; при включённом API-ключе нужен отдельный безопасный способ его передачи. Не открывайте незащищённый сервер в сеть. s1 s4

Зачем читать точку по ID?

Представьте, что у записи известен номер 2 и вы хотите проверить её поле note после загрузки. Точка в Qdrant — запись с ID, вектором и дополнительными полями (payload). Запрос GET /collections/{имя}/points/{id} читает одну точку с известным ID. Если её номер неизвестен, воспользуйтесь обходом Scroll. Чтение по ID не является поиском похожих по смыслу документов и не проверяет права доступа. s1

Как создать учебные точки и прочитать одну?

Сначала подготовьте локальный Qdrant. Убедитесь, что имя demo_get_20261019 не занято на вашем сервере: команды ниже создают коллекцию и записывают точки; не направляйте их в рабочую коллекцию. При другом имени замените его одинаково во всех трёх командах. Размерность вектора 2 здесь нужна только для искусственного примера, а не для реальной AI-модели. s2 s3

Создайте коллекцию: curl -fsS -X PUT 'http://127.0.0.1:6333/collections/demo_get_20261019' -H 'Content-Type: application/json' -d '{"vectors":{"size":2,"distance":"Cosine"}}'. Ожидайте в ответе status: ok и result: true. Если ответ иной, остановитесь и проверьте имя, адрес и работу локального сервера, не переходя к записи. s2

Запишите две тестовые точки: curl -fsS -X PUT 'http://127.0.0.1:6333/collections/demo_get_20261019/points?wait=true' -H 'Content-Type: application/json' -d '{"points":[{"id":1,"vector":[1,0],"payload":{"note":"alpha"}},{"id":2,"vector":[0,1],"payload":{"note":"beta"}}]}'. Ожидайте status: ok и result.status: completed. Повторная отправка с теми же ID перезапишет прежние точки в этой коллекции. s3

Прочитайте только точку 2: curl -fsS 'http://127.0.0.1:6333/collections/demo_get_20261019/points/2'. Проверьте в поле result значения id: 2 и payload.note: beta. Это ожидаемый результат для заданных нами входных данных, не скриншот или вывод работающего у редакции Qdrant. s1

Что делать, если запись не нашлась?

Сверьте имя коллекции и ID с теми, что использовали при записи; ID 1 и 2 относятся только к нашему примеру. Если сервер требует API-ключ, этот неавторизованный запрос не подойдёт: не размещайте ключ в статье, общих журналах команд или URL. Если вам нужен список ID, а не одна запись, откройте гайд по Scroll. Успешный ответ localhost сам по себе не доказывает, что сервер закрыт от других устройств; доступ проверяется отдельно. s1 s4

Источники