Azure AI 検索 の OData 比較演算子 - eq、 ne、 gt、 lt、ge、le

Azure AI の OData フィルター式で最も基本的な演算は、フィールドと特定の値との比較です。 等価比較と範囲比較の 2 種類の比較を行うことができます。 次の演算子を使用して、フィールドを定数値と比較できます。

等価演算子:

• 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'

対話型の構文ダイアグラムも利用できます。

比較式には 2 つの形式があります。 この 2 つの形式の唯一の違いは、定数が演算子の左側に示されるか右側に示されるかです。 演算子の反対側の式は、変数または関数呼び出しでなければなりません。 変数は、フィールド名、または範囲変数 (ラムダ式の場合) のいずれかです。

比較用のデータ型

比較演算子の両側のデータ型には互換性がなければなりません。 たとえば、左側が Edm.DateTimeOffset 型のフィールドの場合、右側は日時定数でなければなりません。 数値データ型は、より柔軟です。 次の表に示すように、いくつかの制限はありますが、任意の数値型の変数と関数を他の数値型の定数と比較できます。

許可されていない比較 (たとえば、型 Edm.Int64 のフィールドと NaN の比較) が行われた場合、Azure AI 検索 REST API は "HTTP 400: 無効な要求" のエラーを返します。

null と NaN の特殊なケース

比較演算子を使用する場合、Azure AI 検索 のすべての非コレクション フィールドは null になる可能性があることを覚えておく必要があります。 次の表に、いずれかの側が null になる可能性がある比較式の考えられるすべての結果を示します。

要約すると、null はそれ自体にのみ等しく、他のどの値より小さくも大きくもありません。

インデックスに型 Edm.Double のフィールドがあり、NaN の値をそれらのフィールドにアップロードする場合は、フィルターを作成するときにそのことを考慮する必要があります。 Azure AI 検索 では、NaN 値を処理するために IEEE 754 標準を実装しています。このような値との比較により、次の表に示すように、明らかではない結果が生じます。

つまり、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日午前0時(UTC)以降に等しいかそれ以上であるドキュメントを一致させる。

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

Details/Sku フィールドが null ではないドキュメントを一致させる場合:

Details/Sku ne null

少なくとも 1 つの部屋のタイプが "Deluxe Room" であり、Rooms/Type フィールドの文字列がフィルターと正確に一致するホテルのドキュメントを一致させる場合:

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

次のステップ

• Azure AI 検索のフィルター
• Azure AI 検索 の OData 式言語の概要
• Azure AI 検索の OData 式構文参照
• ドキュメントの検索 (Azure AI 検索 REST API)