通过

Azure AI 搜索中的 OData 逻辑运算符 - and、or、not

  • 项目

Azure AI 搜索中的 OData 筛选器表达式是求值结果为 true 或 false 的布尔表达式。 你可以编写复杂的筛选器，只需先编写一系列较简单的筛选器，然后使用布尔代数中的逻辑运算符将其组合在一起即可：

  • and：一个二元运算符，在左侧和右侧的子表达式的求值结果均为 true 的情况下，其求值结果为 true。
  • or：一个二元运算符，在左侧或右侧的子表达式的求值结果为 true 的情况下，其求值结果为 true。
  • not：一个一元运算符，在子表达式的求值结果为 false 的情况下，其求值结果为 true，反之亦然。

可以使用这些运算符以及集合运算符 any 和 all 来构建筛选器，以便表述很复杂的搜索条件。

语法

以下 EBNF（扩展巴科斯-瑙尔范式）定义一个使用逻辑运算符的 OData 表达式的语法。

logical_expression ::=
    boolean_expression ('and' | 'or') boolean_expression
    | 'not' boolean_expression

下面还提供了交互式语法图：

Azure AI 搜索的 OData 语法图

注意

请参阅适用于 Azure AI 搜索的 OData 表达式语法参考以获取完整的 EBNF。

有两种形式的逻辑表达式：二元表达式 (and/or) 和一元表达式 (not)，前者有两个子表达式，后者只有一个子表达式。 子表达式可以是任何类型的布尔表达式：

  • 类型为 Edm.Boolean 的字段或范围变量
  • 返回值的类型为 Edm.Boolean 的函数，例如 geo.intersects 或 search.ismatch
  • 比较表达式，例如 rating gt 4
  • 集合表达式，例如 Rooms/any(room: room/Type eq 'Deluxe Room')
  • 布尔文本值 true 或 false。
  • 使用 and、or 和 not 构造的其他逻辑表达式。

重要

某些情况下，并非所有类型的子表达式都可以与 and/or 配合使用，尤其是在 lambda 表达式中。 有关详细信息，请参阅 Azure AI 搜索中的 OData 集合运算符。

逻辑运算符和 null

大多数布尔表达式（例如函数表达式和比较表达式）不会生成 null 值，逻辑运算符不能直接应用于 null 文本（例如，不允许 x and null）。 但是，布尔字段可以是 null，因此你需要了解 and、or 和 not 运算符在 null 存在时的行为。 这在下表中进行了汇总，其中，b 是类型为 Edm.Boolean 的字段：

表达式 当 b 为 null 时的结果
b false
not b true
b eq true false
b eq false false
b eq null true
b ne true true
b ne false true
b ne null false
b and true false
b and false false
b or true true
b or false false

当布尔字段 b 本身出现在筛选器表达式中时，它会表现得像是编写为 b eq true 一样。因此，如果 b 为 null，则表达式的求值结果为 false。 类似地，not b 表现得像 not (b eq true)，因此其求值结果为 true。 同样，null 字段表现得像 false。 这与通过 and 和 or 将它们与其他表达式组合使用时的表现一致，如上表所示。 尽管如此，直接与 false (b eq false) 比较的求值结果仍为 false。 换言之，null 不等于 false，尽管其在布尔表达式中的行为与之类似。

示例

匹配 rating 字段为 3 到 5（含）的文档：

    rating ge 3 and rating le 5

匹配 ratings 字段的所有元素都小于 3 或大于 5 的文档：

    ratings/all(r: r lt 3 or r gt 5)

匹配 location 字段在给定的多边形之内的文档，文档不含“public”一词。

    geo.intersects(location, geography'POLYGON((-122.031577 47.578581, -122.031577 47.678581, -122.131577 47.678581, -122.031577 47.578581))') and not search.ismatch('public')

匹配加拿大温哥华酒店的文档，此类酒店存在基础费率不到 160 加元的豪华客房：

    Address/City eq 'Vancouver' and Address/Country eq 'Canada' and Rooms/any(room: room/Type eq 'Deluxe Room' and room/BaseRate lt 160)

后续步骤