鉴于Milvus仍在不停的迭代新版本，推出新功能，其SDK目前并不稳定。目前其2.4版本的SDK接口已与之前的2.2版本有了较大的差别，功能上也有了一定的调整。为此，我们重新提供了针对Milvus2.4版本的语法转换功能。由于Milvus文档有些内容写的不是特别详实，亦或时间仓促，我们没有正确理解其功能含义，转换工作可能存在一些问题，还请发现问题的朋友多多指出。
我们选择Milvus2.4版本进行语法支持的主要原因是，2.4版本是Milvus目前最新的版本，该版本引入了可以建立多个向量索引的能力。在微软推出的GraphRAG技术中，用到了多向量检索的技术，而Milvus2.2版只支持单向量，无法复刻GraphRAG的技术理念。为此，我们选中了2.4版本进行语法支持。对于未来Milvus版本发生改变，我们是否能及时支持，主要取决于我们在HuggingFists项目中是否会用到这样的技术特性。本次升级的主要动力来自于我们希望使用HuggingFists采用低代码方式来实践GraphRAG项目中的技术理念。当然，如果有朋友对未来某个版本有语法转换需求也可以给我们提出需求，我们会尽量满足。
言归正传，为了能让使用者以类似访问关系数据库的交互体验访问Milvus向量数据库。MOQL Transx继续秉承能SQL化检索数据库就SQL化检索数据库的宗旨。为用户提供了一套可以检索Milvus2.4向量数据库的SQL语法，并提供了检索接口。使用者可通过该接口输入SQL语句，获得结构化的数据结果，如下列代码示例：
// 构建Milvus客户端String url = String.format("%s://%s:%d", "http" ,"datayoo05", 19530);ConnectConfig connectConfig = ConnectConfig.builder().uri(url).build();milvusClient = new MilvusClientV2(connectConfig);// 装载CollectionLoadCollectionReq loadCollectionReq = LoadCollectionReq.builder().collectionName("hybrid_search_collection").build();milvusClient.loadCollection(loadCollectionReq);// 使用Milvus客户端创建Milvus查询器MilvusQuerier milvusQuerier = new MilvusQuerier(milvusClient);String sql = "select * from hybrid_search_collection a, "// 用子检索语句检索向量字段+ "(select * from hybrid_search_collection where vmatch(dense, 'L2', '[[1.0, 2.0, 3.0],[1.1,2.1,3.1]]')) b, "// 用子检索语句检索稀疏向量+ "(select * from hybrid_search_collection where vmatch(sparse, 'IP', '[{\"2\":0.1764169}, {\"5\":0.1764169}]')) c limit 5";// 检索CollectionRecordSet recordSet = milvusQuerier.query(sql);
Milvus2.4的SDK相较Milvus2.2有了不少改变，主要是方法参数上的变动比较大。比如Milvus2.2中SearchParam在Milvus2.4中变成了SearchReq。但SDK的整体思路没有太大的变化，我们在这里就不再赘述了。下表将给出Milvus2.4查询接口的参数与SQL语法的对照关系，其中的粗体为Milvus2.4新增的检索能力，删除线标记的语法部分在Milvus2.2中有效，由于未在2.4的文档中找到相应的说明，故标为删除：
Milvus查询参数接口
SQL语法
collectionName(table)
from table
outFields(outFields)
select outFields
filter(expr)
where expr
annsField, params:metric_type, data
vMatch(fieldName, metricType, vectors)
consistencyLevel
consistencyLevel(['STRONG'|'BOUNDED'|'Eventually'])
topK(k)
limit offset, k
offset(o)
limit offset, k
params:nProbe
nProbe(long)
params:ef
ef(long)
params:search_k
searchK(long)
partitionNames
partitionBy(String[])
roundDecimal
roundDecimal(int)
travelTimestamp
travelTimestamp(long)
guaranteeTimestamp
guaranteeTimestamp(long)
range
searchRange(metricType, radius, rangeFilter)
group
group by fieldName
dropRatio
dropRatioSearch(dropRatio)
searchRequests
from table, [queryExpression]{0,10}
ranker
rrfRanker(k), weightedRanker(float[])
( 注：queryExpression是一个表示向量检索的子SQL语句)
