Infinity项目RESTful API搜索语法更新解析

Infinity项目近期对其RESTful API的搜索语法进行了重要更新，这一改动将显著提升开发者在使用向量数据库时的查询灵活性和功能性。本文将深入分析这次语法更新的技术细节及其带来的优势。

语法结构变更

新版本的搜索API采用了更加统一和模块化的语法结构。主要变更包括：

1. 搜索方法整合：原先分散的match_dense、match_text和match_sparse等独立字段现在被整合到一个search数组中，每个搜索方法作为数组中的一个独立对象。

2. 方法标识统一：每种搜索方法现在使用match_method字段明确标识其类型（如"dense"、"text"或"sparse"），使API更加自描述。

3. 融合方法独立：融合方法（如RRF）现在也作为search数组中的一个独立对象存在，通过fusion_method字段标识。

新语法示例

"search": [
    {
        "match_method": "dense",
        "fields": "dense_column",
        "query_vector": [1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0],
        "metric_type": "l2",
        "topn": 2,
        "params": {"ef": "10"}
    },
    {
        "match_method": "text",
        "fields": "body",
        "matching_text": "bloom",
        "topn": 1,
        "params": {
            "default_fields": "body",
            "operator": "or"
        }
    },
    {
        "match_method": "sparse",
        "fields": "sparse_column",
        "query_vector": [1.0, 2.0],
        "metric_type": "l2",
        "topn": 3,
        "params": {"ef": "150"}   
    },
    {
        "fusion_method": "rrf",
        "topn": 2,
        "params":{"rank_constant": 60}
    }
]

技术优势分析

1. 统一性增强：新的语法结构将所有搜索方法统一在search数组下，使得API更加一致和可预测。

2. 扩展性提升：模块化的设计使得未来添加新的搜索方法（如张量匹配）更加容易，不会破坏现有API结构。

3. 可读性改善：明确的match_method和fusion_method字段使得API请求的意图更加清晰，便于开发者理解和维护。

4. 参数组织优化：每种搜索方法的参数都集中在其所属的对象中，减少了参数命名冲突的可能性。

张量匹配支持

除了上述变更外，项目还新增了对张量匹配的支持，相关参数包括：

• field: 指定用于重排的张量列名
• query_tensor: 用于比较的张量数据，可以是嵌套列表或二维NumPy数组
• element_type: 查询张量的元素数据类型，通常为"float"

总结

Infinity项目的这次API语法更新体现了现代数据库API设计的最佳实践，通过统一的结构和明确的语义，为开发者提供了更强大、更灵活的搜索能力。这种设计不仅改善了当前的使用体验，也为未来的功能扩展奠定了良好的基础。开发者现在可以更直观地构建复杂的多模态搜索查询，并利用融合方法获得更精准的结果排序。