Orama 项目新增搜索字段投影功能优化数据传输效率

背景介绍

在现代搜索应用中，数据检索效率是一个关键考量因素。Orama 作为一个高性能的全文搜索引擎，近期社区提出了一个关于优化搜索结果数据传输的改进建议。该功能灵感来源于 MongoDB 的投影操作，旨在通过指定返回字段来减少不必要的数据传输。

功能需求分析

在服务器端使用 Orama 时，客户端往往不需要获取文档的全部字段。例如，一个产品搜索可能只需要返回名称和描述，而不需要价格、评分等详细信息。当前 Orama 的核心库 @orama/orama 缺少这种字段筛选能力，导致每次搜索都会返回完整的文档结构，造成网络传输资源的浪费。

技术实现方案

Orama Cloud 已经实现了名为 returning 的搜索参数，其工作方式如下：

const searchResult = await search(db, {
  term: 'headphones',
  returning: ['name', 'description']
})

这种实现属于"包含式投影"(inclusive projection)，即明确指定需要返回的字段列表，其他所有字段将被排除在结果之外。与 MongoDB 不同，这个方案暂不实现"排除式投影"(exclusive projection)，以保持接口简洁性。

性能考量

值得注意的是，字段过滤操作本身会有一定的性能开销：

1. 在服务器端执行时，虽然增加了少量CPU开销，但显著减少了网络传输数据量，整体上是值得的
2. 在客户端执行时则完全相反，因为数据已经传输到客户端，此时过滤只会增加处理时间而没有实际收益

因此，这个功能主要推荐在服务器端使用，文档中需要明确说明这一点以避免误用。

实际应用示例

假设有一个电子产品数据库，包含以下字段结构：

{
  name: 'string',
  description: 'string',
  price: 'number',
  meta: {
    rating: 'number',
  }
}

使用字段投影功能后，搜索结果将只包含指定的字段，例如只返回产品名称和描述：

{
  hits: [{
    document: {
      name: 'Wireless Headphones',
      description: 'Experience immersive sound quality...'
    }
  }]
}

总结

Orama 新增的搜索字段投影功能为开发者提供了更精细的数据控制能力，特别适合以下场景：

• 带宽有限的移动应用
• 需要优化API响应速度的服务
• 只需要文档部分字段的查询场景

这一改进使 Orama 在保持高性能的同时，进一步提升了资源利用效率，为构建更优化的搜索体验提供了新的可能性。