OramaSearch 中数组属性的过滤行为解析

数组属性过滤的基本原理

在OramaSearch中，当我们需要对包含数组类型的属性进行过滤查询时，其行为逻辑与常规属性有所不同。数组过滤的核心原则是：只要数组中至少有一个元素满足过滤条件，整个文档就会被视为匹配。

支持的数据类型

OramaSearch支持对以下类型的数组属性进行过滤操作：

1. 字符串数组(string[])
2. 数字数组(number[])
3. 布尔值数组(boolean[])

操作符使用规范

数组属性可以使用的操作符与其元素类型完全一致。例如：

• 字符串数组支持contains、startsWith等字符串操作符
• 数字数组支持gt、gte、lt、lte等数值比较操作符
• 布尔值数组支持简单的true/false匹配

实际应用示例

让我们通过一个实际的代码示例来理解数组过滤的行为：

// 创建包含数组属性的schema
const db = await create({
  schema: {
    title: "string",
    tags: "string[]",
    editions: "number[]",
    limited: "boolean[]",
  }
});

// 插入测试数据
await insertMultiple(db, [
  {title: "a", tags: ["foo", "bar"], editions: [1990, 2024], limited: [false, false]},
  {title: "b", tags: ["foo"], editions: [1942, 2024], limited: [false, true]},
  {title: "c", tags: ["bar"], editions: [2020], limited: [false]},
])

字符串数组过滤

查找所有包含"foo"标签的书籍：

await search(db, {where: {tags: "foo"}});
// 返回文档a和b，因为它们的tags数组中至少有一个元素是"foo"

查找标签为"foo"或"bar"的书籍：

await search(db, {where: {tags: ["foo", "bar"]}});
// 返回所有三个文档，因为每个文档的tags数组中都至少包含其中一个值

数字数组过滤

查找有2024年版次的书籍：

await search(db, {where: {editions: {eq: 2024}}});
// 返回文档a和b，因为它们的editions数组中包含2024

布尔值数组过滤

查找有限量版的书籍：

await search(db, {where: {limited: true}});
// 只返回文档b，因为只有它的limited数组中包含true

性能优化建议

当处理大型数组属性时，需要注意以下几点：

1. 数组元素越多，过滤操作可能越耗时
2. 对于频繁查询的数组属性，考虑建立适当的索引
3. 尽量避免在同一个查询中对多个大型数组属性进行复杂过滤

总结

OramaSearch对数组属性的过滤提供了灵活而强大的支持，遵循"至少一个元素匹配"的原则。这种设计既符合直觉，又能满足大多数实际应用场景的需求。开发者可以根据业务需求，灵活运用各种操作符对数组属性进行精确查询。