org.dromara.milvus.plus.service

接口 IVecMService

public interface IVecMService

方法概要

限定符和类型	方法和说明
default io.milvus.v2.service.vector.response.DeleteResp	delete(String collectionName, String partitionName, String filter, List<Object> ids) 根据ID或布尔表达式删除指定集合中的实体
default io.milvus.v2.service.vector.response.DeleteResp	deleteByFilter(String collectionName, String filter) 根据过滤条件删除指定集合中的实体
default io.milvus.v2.service.vector.response.DeleteResp	deleteByIds(String collectionName, List<Object> ids) 根据ID列表删除指定集合中的实体
default io.milvus.v2.service.vector.response.GetResp	get(String collectionName, String partitionName, List<Object> ids, List<String> outputFields) 根据ID获取指定集合中的特定实体
default io.milvus.v2.service.vector.response.GetResp	getById(String collectionName, Object id)
default io.milvus.v2.service.vector.response.GetResp	getByIds(String collectionName, List<Object> ids) 根据ID列表获取指定集合中的实体，不指定分区，返回所有字段
io.milvus.v2.client.MilvusClientV2	getClient()
default io.milvus.v2.service.vector.response.InsertResp	insert(String collectionName, com.google.gson.JsonObject data) 向指定集合和分区插入单条数据
default io.milvus.v2.service.vector.response.InsertResp	insert(String collectionName, List<com.google.gson.JsonObject> data, String partitionName) 向指定集合插入数据
default io.milvus.v2.service.vector.response.QueryResp	query(String collectionName, List<String> partitionNames, List<String> outputFields, List<Object> ids, String filter, io.milvus.v2.common.ConsistencyLevel consistencyLevel, long offset, long limit) 根据标量过滤条件进行查询
default io.milvus.v2.service.vector.response.QueryResp	queryByFilter(String collectionName, List<String> outputFields, String filter, io.milvus.v2.common.ConsistencyLevel consistencyLevel, long offset, long limit) 根据过滤条件查询指定集合中的实体，不指定分区和ID
default io.milvus.v2.service.vector.response.SearchResp	search(String collectionName, List<io.milvus.v2.service.vector.request.data.BaseVector> data, int topK) 便利方法：执行向量相似性搜索，不包含标量过滤表达式
default io.milvus.v2.service.vector.response.SearchResp	search(String collectionName, List<String> partitionNames, String annsField, int topK, String filter, List<String> outputFields, List<io.milvus.v2.service.vector.request.data.BaseVector> data, long offset, long limit, int roundDecimal, Map<String,Object> searchParams, long guaranteeTimestamp, long gracefulTime, io.milvus.v2.common.ConsistencyLevel consistencyLevel, boolean ignoreGrowing) 执行向量相似性搜索，可选择性地包含标量过滤表达式
default io.milvus.v2.service.vector.response.UpsertResp	upsert(String collectionName, com.google.gson.JsonObject data) 便利方法：在指定集合中插入或更新单条数据
default io.milvus.v2.service.vector.response.UpsertResp	upsert(String collectionName, String partitionName, List<com.google.gson.JsonObject> data) 在指定集合中插入或更新数据

方法详细资料

getClient

io.milvus.v2.client.MilvusClientV2 getClient()

delete

default io.milvus.v2.service.vector.response.DeleteResp delete(String collectionName,
                                                               String partitionName,
                                                               String filter,
                                                               List<Object> ids)
                                                        throws io.milvus.exception.MilvusException

根据ID或布尔表达式删除指定集合中的实体

参数:

collectionName - 集合名称

partitionName - 分区名称，如果为空，则在指定集合的所有分区中查找实体

filter - 用于筛选匹配实体的标量过滤条件，默认为空字符串，表示不应用此条件

ids - 要删除的实体ID列表，如果为空，则根据filter条件删除

返回:

DeleteResp对象，包含被删除实体的数量

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

deleteByFilter

default io.milvus.v2.service.vector.response.DeleteResp deleteByFilter(String collectionName,
                                                                       String filter)
                                                                throws io.milvus.exception.MilvusException

根据过滤条件删除指定集合中的实体

参数:

collectionName - 集合名称

filter - 用于筛选匹配实体的布尔表达式

返回:

DeleteResp对象，包含被删除实体的数量

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

deleteByIds

default io.milvus.v2.service.vector.response.DeleteResp deleteByIds(String collectionName,
                                                                    List<Object> ids)
                                                             throws io.milvus.exception.MilvusException

根据ID列表删除指定集合中的实体

参数:

collectionName - 集合名称

ids - 要删除的实体ID列表

返回:

DeleteResp对象，包含被删除实体的数量

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

get

default io.milvus.v2.service.vector.response.GetResp get(String collectionName,
                                                         String partitionName,
                                                         List<Object> ids,
                                                         List<String> outputFields)
                                                  throws io.milvus.exception.MilvusException

根据ID获取指定集合中的特定实体

参数:

collectionName - 集合名称

partitionName - 分区名称，如果为空，则在指定集合的所有分区中查找实体

ids - 要查询的实体ID列表

outputFields - 查询结果中需要包含的字段名称列表

返回:

GetResp对象，表示一个或多个被查询的实体

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

getByIds

default io.milvus.v2.service.vector.response.GetResp getByIds(String collectionName,
                                                              List<Object> ids)
                                                       throws io.milvus.exception.MilvusException

根据ID列表获取指定集合中的实体，不指定分区，返回所有字段

参数:

collectionName - 集合名称

ids - 要查询的实体ID列表

返回:

GetResp对象，表示一个或多个被查询的实体

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

getById

default io.milvus.v2.service.vector.response.GetResp getById(String collectionName,
                                                             Object id)
                                                      throws io.milvus.exception.MilvusException

抛出:

io.milvus.exception.MilvusException

insert

default io.milvus.v2.service.vector.response.InsertResp insert(String collectionName,
                                                               List<com.google.gson.JsonObject> data,
                                                               String partitionName)
                                                        throws io.milvus.exception.MilvusException

向指定集合插入数据

参数:

collectionName - 集合名称

data - 要插入的数据列表，数据结构应与集合的schema匹配

partitionName - 分区名称，如果为空，则数据将插入到默认分区

返回:

InsertResp对象，包含插入实体的数量信息

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

insert

default io.milvus.v2.service.vector.response.InsertResp insert(String collectionName,
                                                               com.google.gson.JsonObject data)
                                                        throws io.milvus.exception.MilvusException

向指定集合和分区插入单条数据

参数:

collectionName - 集合名称

data - 要插入的数据，数据结构应与集合的schema匹配

返回:

InsertResp对象，包含插入实体的数量信息

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

query

default io.milvus.v2.service.vector.response.QueryResp query(String collectionName,
                                                             List<String> partitionNames,
                                                             List<String> outputFields,
                                                             List<Object> ids,
                                                             String filter,
                                                             io.milvus.v2.common.ConsistencyLevel consistencyLevel,
                                                             long offset,
                                                             long limit)
                                                      throws io.milvus.exception.MilvusException

根据标量过滤条件进行查询

参数:

collectionName - 集合名称

partitionNames - 分区名称列表，如果为空，则查询整个集合

outputFields - 查询结果中需要包含的字段名称列表

ids - 要查询的实体ID列表，如果为空，则根据filter条件查询

filter - 标量过滤条件，用于筛选匹配的实体

consistencyLevel - 一致性级别，默认为集合创建时指定的级别

offset - 查询结果中要跳过的记录数，用于分页

limit - 查询结果返回的记录数，用于分页

返回:

查询结果对象列表，包含指定输出字段的特定查询结果

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

queryByFilter

default io.milvus.v2.service.vector.response.QueryResp queryByFilter(String collectionName,
                                                                     List<String> outputFields,
                                                                     String filter,
                                                                     io.milvus.v2.common.ConsistencyLevel consistencyLevel,
                                                                     long offset,
                                                                     long limit)
                                                              throws io.milvus.exception.MilvusException

根据过滤条件查询指定集合中的实体，不指定分区和ID

参数:

collectionName - 集合名称

outputFields - 查询结果中需要包含的字段名称列表

filter - 标量过滤条件

consistencyLevel - 一致性级别

offset - 跳过的记录数

limit - 返回的记录数

返回:

查询结果对象列表

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

search

default io.milvus.v2.service.vector.response.SearchResp search(String collectionName,
                                                               List<String> partitionNames,
                                                               String annsField,
                                                               int topK,
                                                               String filter,
                                                               List<String> outputFields,
                                                               List<io.milvus.v2.service.vector.request.data.BaseVector> data,
                                                               long offset,
                                                               long limit,
                                                               int roundDecimal,
                                                               Map<String,Object> searchParams,
                                                               long guaranteeTimestamp,
                                                               long gracefulTime,
                                                               io.milvus.v2.common.ConsistencyLevel consistencyLevel,
                                                               boolean ignoreGrowing)
                                                        throws io.milvus.exception.MilvusException

执行向量相似性搜索，可选择性地包含标量过滤表达式

参数:

collectionName - 集合名称

partitionNames - 分区名称列表，如果为空，则搜索整个集合

annsField - 向量字段名称，当存在多个向量字段时使用

topK - 返回搜索结果记录数

filter - 标量过滤条件，用于筛选匹配的实体

outputFields - 查询结果中需要包含的字段名称列表

data - 查询向量嵌入列表

offset - 查询结果中要跳过的记录数，用于分页

limit - 返回的记录数，用于分页

roundDecimal - 计算距离结果保留的小数位数

searchParams - 特定于此操作的参数设置

guaranteeTimestamp - 有效的时间戳

gracefulTime - 一个时间段（毫秒）

consistencyLevel - 一致性级别

ignoreGrowing - 是否在相似性搜索期间忽略增长段

返回:

搜索结果对象列表，包含指定输出字段和相关性分数的特定搜索结果

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

search

default io.milvus.v2.service.vector.response.SearchResp search(String collectionName,
                                                               List<io.milvus.v2.service.vector.request.data.BaseVector> data,
                                                               int topK)
                                                        throws io.milvus.exception.MilvusException

便利方法：执行向量相似性搜索，不包含标量过滤表达式

参数:

collectionName - 集合名称

data - 查询向量嵌入列表

topK - 返回搜索结果记录数

返回:

搜索结果对象列表

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

upsert

default io.milvus.v2.service.vector.response.UpsertResp upsert(String collectionName,
                                                               String partitionName,
                                                               List<com.google.gson.JsonObject> data)
                                                        throws io.milvus.exception.MilvusException

在指定集合中插入或更新数据

参数:

collectionName - 集合名称

partitionName - 分区名称，如果为空，则数据将插入或更新到默认分区

data - 要插入或更新的数据列表，数据结构应与集合的schema匹配

返回:

UpsertResp对象，包含插入或更新实体的数量信息

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误

upsert

default io.milvus.v2.service.vector.response.UpsertResp upsert(String collectionName,
                                                               com.google.gson.JsonObject data)
                                                        throws io.milvus.exception.MilvusException

便利方法：在指定集合中插入或更新单条数据

参数:

collectionName - 集合名称

data - 要插入或更新的单个数据，数据结构应与集合的schema匹配

返回:

UpsertResp对象，包含插入或更新实体的数量信息

抛出:

io.milvus.exception.MilvusException - 如果操作过程中发生错误