云原生数据仓库AnalyticDB：QueryCollectionData - 召回向量数据

实例 ID。

集合名。

命名空间。

命名空间对应的密码。

用于全文检索的内容。即此值为空时，仅使用向量检索；不为空时，使用向量和全文双路检索。

要查询的数据的过滤条件，格式为 SQL 的 WHERE 格式。是一个返回布尔值（真或假）的表达式，条件可以是简单的比较运算符，如等于(=)、不等于(<>或!=)、大于(>), 小于(<)、大于等于(>=)、小于等于(<=)，也可以是逻辑运算符（AND, OR, NOT）组合的更复杂的表达式，以及使用 IN、BETWEEN、LIKE 等关键字的条件。

设置返回 top 结果数量。

向量数据，长度和 CreateCollection 接口的维度一致。

稀疏向量数据列表。

实例所在地域 ID。

检索时的相似度算法。取值说明：

• l2：欧氏距离。
• ip：点积（内积）距离。
• cosine：余弦相似度。

是否返回向量数据。取值说明：

• true：返回向量数据。
• false：不返回向量数据，用于全文检索场景。

双路召回算法，默认为空(即直接将向量和全文的分数比较并排序)。

可选值：

• RRF：倒数排序融合(Reciprocal rank fusion)，有一个参数 k 控制融合效果，详见 HybridSearchArgs 配置；
• Weight：比重排序，采用一个参数 alpha 控制向量和全文的分数比重，然后再排序，参数详见 HybridSearchArgs 配置；
• Cascaded：先全文检索再在其基础上进行向量检索；

双路召回的算法参数。目前支持 RRF 和 Weight 两种：

• RRF：指定计算分数的算法的1/(k+rank_i)中的 k 常数，范围大于 1 的正整数，格式为：

{ 
   "RRF": {
    "k": 60
   }
}

• Weight: 计算公式alpha * vector_score + (1-alpha) * text_score，参数 alpha 表示向量和全文的检索分数比重，范围为 0～1，其中 0 表示只全文，1 表示只向量：

{ 
   "Weight": {
    "alpha": 0.5
   }
}

默认为空，表示排序的依据字段。不支持双路召回场景。

字段必须属于 metadata 或表里的默认字段比如 id，格式支持：

• 单个字段，如 chunk_id；
• 多个字段，用逗号连接，如 block_id, chunk_id；
• 支持反序，如: block_id DESC, chunk_id DESC；

默认为空，表示分页查询时的检索起点。不支持双路召回场景。

范围必须>=0。当此值不为空时，会返回 Total 表示总的命中数。此参数配合 TopK 使用，比如要分页 20 检索 chunk_id 0~44 的 chunks，则要请求 3 次：

• Offset=0,TopK=20 返回 chunk_id 0~19
• Offset=20,TopK=20 返回 chunk_id 20~39
• Offset=30,TopK=20 返回 chunk_id 40~44

默认为空，表示要返回的 metadata 字段，多个字段用逗号分隔。

多数据库实例组成的 Workspace 的 Id。此参数和 DBInstanceId 参数不能同时为空，当和 DBInstanceId 同时指定时以此参数为准。

使用另外一张关系表实现向量数据过滤（类似 Join 的功能）。