首页/AI/RAG 与向量库速查/Milvus Lite 本地开发模式

Milvus Lite 本地开发模式

Milvus Lite 是嵌入式的轻量版本:pymilvus 直接指向本地文件即可运行,适合原型、单机小数据与 CI 环境;不支持分布式特性与部分高级索引,迁移到服务端时接口保持一致。

RAG 与向量库速查AI更新于 2026-10-13

Milvus Lite 是什么

Milvus Lite 是嵌入式的轻量版本:客户端直接指向一个本地文件即可运行,不需要部署服务端,适合原型、单机小数据与持续集成环境。它不支持分布式特性与部分高级索引,容量与并发都有实际上限;好处是接口与服务端基本一致,从本地原型切到服务端通常只需要改连接串,因此原型代码要尽量避免依赖 Lite 独有行为。

基本信息

形态嵌入式,数据落在本地文件
获取方式随客户端库提供,无需单独部署
初始化客户端指向本地文件路径即可
适用场景原型、单机小数据、测试与集成环境
不支持分布式特性与部分高级索引
迁移方式改连接串指向服务端集群

典型使用场景

  • 本地原型验证检索链路是否跑通
  • 单元测试与集成测试里跑端到端用例
  • 单机小工具,不值得为它部署服务端
  • 教学与演示,环境准备成本最低
  • 数据量不大时在本地复现线上问题

用本地文件启动

用本地文件启动
from pymilvus import MilvusClient

client = MilvusClient("./rag_demo.db")          # 本地持久化文件
client.create_collection("demo", dimension=384)
client.insert("demo", [{"id": 1, "vector": [0.1] * 384}])
res = client.search("demo", data=[[0.1] * 384], limit=3)
print(res)
# 迁到服务端:只把文件路径换成服务端地址与凭据

能力边界读法

维度说明注意
部署一个本地文件,随进程启动多进程同时访问同一文件会冲突
容量数据量有实际上限不要把 Lite 当生产集群使用
索引只支持部分索引类型写代码时避开 Lite 不支持的索引
并发并发能力有限压测结论不能代表服务端表现
本地验证管线与 SDK 用法,容量与并发都有上限;切到服务端通常只改连接串,因此原型阶段就要避免依赖 Lite 独有行为。
在持续集成里用 Lite 时,建议每次都用临时文件并在结束时清理:残留的旧文件会让用例读到上一次的数据,产生难以复现的失败。

易错点

  • 用 Milvus Lite 压测并发性能:结论无法代表服务端集群,容量规划直接失真
  • 误用 Lite 不支持的索引类型:代码迁移到服务端之前就在本地报错,返工成本高
  • 多个进程同时打开同一个本地文件:出现锁冲突,写入随机失败
  • 集成测试复用同一个数据文件:用例之间相互污染,失败原因难以定位

数据来源与参考

  • Milvus 官方文档(Milvus Lite)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌