Azure AI 搜索中的 OData 比较运算符 - eq、ne、gt、lt、ge 和 le

在 Azure AI 搜索的 OData 筛选表达式中的最基本运算是将某个字段与给定的值进行比较。 可进行两种类型的比较 -- 相等性比较和范围比较。 可以使用以下运算符将字段与常量值进行比较：

相等性运算符：

• eq：测试某个字段是否等于某个常量值
• ne：测试某个字段是否不等于某个常量值

范围运算符：

• gt：测试某个字段是否大于某个常量值
• lt：测试某个字段是否小于某个常量值
• ge：测试某个字段是否大于或等于某个常量值
• le：测试某个字段是否小于或等于某个常量值

可以结合使用范围运算符和逻辑运算符来测试某个字段是否在特定的值范围内。 请参阅本文稍后提供的示例。

语法

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

comparison_expression ::=
    variable_or_function comparison_operator constant |
    constant comparison_operator variable_or_function

variable_or_function ::= variable | function_call

comparison_operator ::= 'gt' | 'lt' | 'ge' | 'le' | 'eq' | 'ne'

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

比较表达式有两种形式。 它们之间的唯一差别在于，常量是显示在运算符的左侧还是右侧。 运算符另一侧的表达式必须是变量或函数调用。 变量可以是字段名称，或者 Lambda 表达式中的范围变量。

可比较的数据类型

比较运算符两侧的数据类型必须兼容。 例如，如果左侧是 Edm.DateTimeOffset 类型的字段，则右侧必须是日期时间常量。 数字数据类型更灵活。 可将任何数字类型的变量和函数与任何其他数字类型的常量进行比较，但存在下表中所述的几项限制。

对于不允许的比较（例如，将 Edm.Int64 类型的字段与 NaN 进行比较），Azure AI 搜索 REST API 将返回“HTTP 400: 错误请求”错误。

null 和 NaN 的特殊情况

使用比较运算符时，请务必记住，Azure AI 搜索中的所有非集合字段都有可能为 null。 下表显示了任何一侧可为 null 的比较表达式的所有可能结果：

总而言之，null 仅等于自身，而不小于或大于任何其他值。

如果索引包含 Edm.Double 类型的字段，而你将 NaN 值上传到这些字段，则在编写筛选器时需要考虑到这种情况。 Azure AI 搜索实现 IEEE 754 标准来处理 NaN 值，使用此类值的比较将生成不明确的结果，如下表所示。

总而言之，NaN 不等于任何值（包括自身）。

比较地理空间数据

不能直接将 Edm.GeographyPoint 类型的字段与常量值进行比较，但可以使用 geo.distance 函数。 此函数返回 Edm.Double 类型的值，因此，可将此值与数字常量进行比较，以根据与固定地理空间坐标之间的距离进行筛选。 请参阅下面的示例。

比较字符串数据

可以使用 eq 和 ne 运算符在筛选器中比较字符串，以找出完全匹配项。 这些比较区分大小写。

示例

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

Rating ge 3 and Rating le 5

匹配 Location 字段与给定纬度和经度之间的距离小于 2 公里的文档：

geo.distance(Location, geography'POINT(-122.031577 47.578581)') lt 2.0

匹配 LastRenovationDate 字段大于或等于 2015 年 1 月 1 日午夜 (UTC) 的文档：

LastRenovationDate ge 2015-01-01T00:00:00.000Z

匹配 Details/Sku 字段不为 null 的文档：

Details/Sku ne null

匹配至少提供一间“豪华客房”，且 Rooms/Type 字段的字符串与筛选器完全匹配的酒店的文档：

Rooms/any(room: room/Type eq 'Deluxe Room')

后续步骤

• Azure AI 搜索中的筛选器
• Azure AI 搜索的 OData 表达式语言概述
• Azure AI 搜索的 OData 表达式语法参考
• 搜索文档（Azure AI 搜索 REST API）