Azure AI 搜索中的 OData 集合运算符 -
编写 OData 筛选器表达式以用于Azure AI 搜索时，筛选集合字段通常很有用。 可以使用 any 和 all 运算符实现这一点。
语法
以下 EBNF（扩展巴科斯-瑙尔范式）定义了使用 any 或 all 的 OData 表达式的语法。
collection_filter_expression ::=
field_path'/all(' lambda_expression ')'
| field_path'/any(' lambda_expression ')'
| field_path'/any()'
lambda_expression ::= identifier ':' boolean_expression
下面还提供了交互式语法图：
注意事项
请参阅 适用于 Azure AI 搜索的 OData 表达式语法参考，以获取完整的 EBNF。
有三种形式的表达式可以筛选集合。
- 前两个迭代遍历集合，将以 lambda 表达式形式给定的谓词应用于集合的每个元素。
- 如果集合的每个元素的谓词都为 true，则使用
all的表达式将返回true。 - 如果集合的至少一个元素的谓词为 true，则使用
any的表达式将返回true。
- 如果集合的每个元素的谓词都为 true，则使用
- 第三种形式的集合筛选器使用不带 lambda 表达式的
any来测试集合字段是否为空。 如果集合有任何元素，则返回true。 如果集合为空，则返回false。
集合筛选器中的 lambda 表达式类似于编程语言中loop的正文。 它定义了一个变量，称为范围变量，它在迭代期间保存集合的当前元素。 它还定义了另一个布尔表达式，该表达式是应用于集合的每个元素的范围变量的筛选条件。
示例
匹配 tags 字段恰好包含字符串“wifi”的文档：
tags/any(t: t eq 'wifi')
匹配其中 ratings 字段的每个元素介于 3 和 5 之间（包括 3 和 5）的文档：
ratings/all(r: r ge 3 and r le 5)
匹配 locations 字段中任何地理坐标系在给定多边形内的文档：
locations/any(loc: geo.intersects(loc, geography'POLYGON((-122.031577 47.578581, -122.031577 47.678581, -122.131577 47.678581, -122.031577 47.578581))'))
匹配其中 rooms 字段为空的文档：
not rooms/any()
匹配 rooms/amenities 字段包含“tv”且 rooms/baseRate 小于 100（针对所有房间）的文档：
rooms/all(room: room/amenities/any(a: a eq 'tv') and room/baseRate lt 100.0)
限制
并非每个筛选器表达式功能都可在 Lambda 表达式主体中使用。 根据要筛选的集合字段的数据类型，限制会有所不同。 下表总结了这些限制。
| 数据类型 | 带 any 的 lambda 表达式中允许的功能 |
带 all 的 lambda 表达式中允许的功能 |
|---|---|---|
Collection(Edm.ComplexType) |
除 search.ismatch 和 search.ismatchscoring 外的所有内容 |
相同 |
Collection(Edm.String) |
使用 eq 或 search.in 进行比较 使用 or 组合子表达式 |
使用 ne 或 not search.in() 进行比较 使用 and 组合子表达式 |
Collection(Edm.Boolean) |
使用 eq 或 ne 进行比较 |
相同 |
Collection(Edm.GeographyPoint) |
将 geo.distance 与 lt 或 le 配合使用 geo.intersects 使用 or 组合子表达式 |
将 geo.distance 与 gt 或 ge 配合使用 not geo.intersects(...) 使用 and 组合子表达式 |
有关这些限制和示例的更多详细信息，请参阅 Azure AI 搜索 中的集合筛选器故障排除。 有关这些限制存在原因的详细信息，请参阅 Azure AI 搜索 中的集合筛选器理解。