qdrant

Qdrant 向量数据库

补充说明

Qdrant 是 Rust 编写的向量数据库，支持 payload 过滤、混合检索、量化和分布式部署。REST 端口 6333，gRPC 端口 6334。适合语义搜索、推荐和 RAG。

常用示例

启动单节点：

docker run -d --name qdrant \
  -p 6333:6333 -p 6334:6334 \
  -v $(pwd)/qdrant_storage:/qdrant/storage \
  qdrant/qdrant

创建集合：

curl -X PUT http://localhost:6333/collections/docs \
  -H 'Content-Type: application/json' \
  -d '{"vectors":{"size":1536,"distance":"Cosine"}}'

写入向量：

curl -X PUT 'http://localhost:6333/collections/docs/points' \
  -H 'Content-Type: application/json' \
  -d '{"points":[{"id":1,"vector":[0.1,0.2],"payload":{"source":"faq"}}]}'

搜索并过滤：

curl -X POST 'http://localhost:6333/collections/docs/points/search' \
  -H 'Content-Type: application/json' \
  -d '{"vector":[0.1,0.2],"limit":5,"filter":{"must":[{"key":"source","match":{"value":"faq"}}]}}'

创建快照：

curl -X POST http://localhost:6333/collections/docs/snapshots

易错点与排错

• 向量维度与集合配置不一致，写入返回 400。
• 距离函数选错，Cosine 和 Dot 的归一化要求不同。
• payload 字段没有建索引，过滤性能很差。
• 单节点没有副本，磁盘故障后数据丢失。
• 大批量写入没有分批，内存和 WAL 压力过大。
• 更新 point 时没有保留原 payload，元数据被覆盖。
• 删除集合后不可恢复，操作前先做快照。
• 集群模式下分片和副本数规划不足，扩容困难。

读完自测

合上页面，先回答，再展开对照。

1. 写入向量返回 400，先核对什么？
2. payload 过滤性能很差，先查什么？
3. 更新 point 后元数据丢失，为什么？