【MilvusPlus】开源下载和安装教程

1、项目介绍

MilvusPlus（简称MP）是专为Milvus向量数据库设计的增强操作库，提供类似MyBatis-Plus的注解式API，简化开发流程。核心特性包括：

• 非侵入式设计，零性能损耗
• 支持Lambda表达式和自动主键生成
• 内置CRUD操作与强大条件构造器
• 注解驱动配置（集合/字段/索引/分区）

2、项目下载位置

通过Maven仓库获取依赖：

<!-- 核心库（非Spring环境） -->
<dependency>
    <groupId>org.dromara.milvus-plus</groupId>
    <artifactId>milvus-plus-core</artifactId>
    <version>2.2.5</version>
</dependency>

<!-- Spring Boot Starter -->
<dependency>
    <groupId>org.dromara.milvus-plus</groupId>
    <artifactId>milvus-plus-boot-starter</artifactId>
    <version>2.2.5</version>
</dependency>

3、安装环境配置

必备环境

• JDK 1.8+
• Milvus 2.0+ 服务（本地或云实例）
• Maven 3.6+

配置示例（application.yml）

milvus:
  uri: https://your-milvus-cluster.api.region.zillizcloud.com
  token: your-access-token
  enable: true
  packages:
    - com.yourproject.entity  # 实体类包路径

4、项目安装方式

步骤1：添加依赖

在pom.xml中引入对应环境的依赖（见第2节）。

步骤2：定义实体类

使用注解声明集合结构：

@MilvusCollection(name = "book")
public class Book {
    @MilvusField(name = "book_id", isPrimaryKey = true)
    private Long id;
    
    @MilvusField(name = "vector", dataType = DataType.FLOAT_VECTOR, dimension = 128)
    private List<Float> vector;
    
    @MilvusIndex(indexType = IndexType.IVF_FLAT, metricType = MetricType.L2)
    private String index;
}

步骤3：继承MilvusMapper

public interface BookMapper extends MilvusMapper<Book> {}

步骤4：启动验证

Spring项目启动时会自动创建集合和索引，日志输出类似：

[MP] Auto-create collection 'book' success
[MP] Auto-create index on field 'vector' with type IVF_FLAT

5、项目处理脚本

手动初始化脚本（可选）

若需手动管理集合，可通过MilvusClient执行：

MilvusClientV2 client = milvusMapper.getClient();
client.createCollection(
    CreateCollectionParam.newBuilder()
        .withCollectionName("book")
        .addFieldType(FieldType.newBuilder()
            .withName("book_id")
            .withDataType(DataType.INT64)
        .build()
);

数据操作示例

// 插入数据
Book book = new Book(1L, Arrays.asList(0.1f, 0.2f));
milvusMapper.insert(book);

// 相似度搜索
LambdaQueryWrapper<Book> wrapper = milvusMapper.queryWrapper()
    .nearestSearch("vector", Arrays.asList(0.15f, 0.25f), 10);
List<Book> results = milvusMapper.search(wrapper);

提示：完整注解说明请参考项目文档中的@MilvusField和@MilvusIndex参数详解。