OData összehasonlító operátorok az Azure AI Keresésben – eq, ne, gt, lt, és gele

Az Azure AI Keresés OData-szűrőkifejezésének legalapvetőbb művelete egy mező és egy adott érték összehasonlítása. Kétféle összehasonlítás lehetséges : egyenlőségi összehasonlítás és tartomány-összehasonlítás. Az alábbi operátorok segítségével összehasonlíthat egy mezőt egy állandó értékkel:

Egyenlőségi operátorok:

• eq: Annak tesztelése, hogy egy mező egyenlő-e állandó értékkel
• ne: Annak tesztelése, hogy egy mező nem egyenlő-e állandó értékkel

Tartomány operátorai:

• gt: Annak tesztelése, hogy egy mező nagyobb-e állandó értéknél
• lt: Annak tesztelése, hogy egy mező kisebb-e állandó értéknél
• ge: Annak tesztelése, hogy egy mező nagyobb-e, mint egy állandó érték, vagy egyenlő-e
• le: Annak ellenőrzése, hogy egy mező kisebb vagy egyenlő-e állandó értéknél

A tartományoperátorok és a logikai operátorok együttes használatával tesztelheti, hogy egy mező egy adott értéktartományon belül van-e. Lásd a példákat a cikk későbbi részében.

Szintaxis

Az alábbi EBNF (Extended Backus-Naur form) az összehasonlító operátorokat használó OData-kifejezés nyelvtanát határozza meg.

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'

Interaktív szintaxisdiagram is elérhető:

Az összehasonlító kifejezéseknek két formája van. Az egyetlen különbség közöttük az, hogy az állandó megjelenik-e az operátor bal vagy jobb oldalán. Az operátor másik oldalán lévő kifejezésnek változónak vagy függvényhívásnak kell lennie. A változó lehet mezőnév vagy tartományváltozó lambda kifejezés esetén.

Adattípusok összehasonlításhoz

Az összehasonlító operátor mindkét oldalán lévő adattípusoknak kompatibilisnek kell lenniük. Ha például a bal oldal egy típusmező Edm.DateTimeOffset, akkor a jobb oldalon dátum-idő állandónak kell lennie. A numerikus adattípusok rugalmasabbak. Bármely numerikus típus változóit és függvényeit összehasonlíthatja bármely más numerikus típus állandóival, néhány korlátozással, az alábbi táblázatban leírtak szerint.

A nem engedélyezett összehasonlítások, például egy típusmező Edm.Int64NaNösszehasonlítása esetén az Azure AI Keresés REST API "HTTP 400: Bad Request" hibaüzenetet ad vissza.

Különleges esetek a következőhöz: null és NaN

Összehasonlító operátorok használatakor fontos megjegyezni, hogy az Azure AI Keresés minden nem gyűjtési mezője potenciálisan lehet null. Az alábbi táblázat egy összehasonlító kifejezés összes lehetséges eredményét mutatja be, ahol mindkét oldal lehet null:

Összefoglalva, null csak önmagával egyenlő, és nem kisebb vagy nagyobb, mint bármely más érték.

Ha az index típusmezőket Edm.Double tartalmaz, és értékeket tölt fel NaN ezekbe a mezőkbe, akkor a szűrők írásakor figyelembe kell vennie azokat. Az Azure AI Keresés implementálja az IEEE 754 szabványt az értékek kezeléséhez NaN , és az ilyen értékekkel való összehasonlítások nem egyértelmű eredményeket eredményeznek, ahogyan az az alábbi táblázatban látható.

Összefoglalva, NaN nem egyenlő semmilyen értékkel, beleértve magát is.

Geo-térbeli adatok összehasonlítása

Egy típusmezőt Edm.GeographyPoint nem hasonlíthat össze közvetlenül állandó értékkel, de használhatja a függvényt geo.distance . Ez a függvény egy típusértéket Edm.Doublead vissza, így összehasonlíthatja egy numerikus állandóval, hogy az állandó geo-térbeli koordináták távolsága alapján szűrjön. Lásd az alábbi példákat .

Sztringadatok összehasonlítása

A szűrőkben a sztringek összehasonlíthatók a pontos egyezésekhez a eq és ne operátorok használatával. Ezek az összehasonlítások megkülönböztetik a kis- és nagybetűket.

Példák

Egyeznie kell azokkal a dokumentumokkal, ahol a Rating mező 3 és 5 között van, beleértve a következőt:

Rating ge 3 and Rating le 5

Keresse meg azokat a dokumentumokat, amelyeknél a Location mező kevesebb mint 2 kilométerre van a megadott földrajzi szélesség és hosszúság alapján:

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

Olyan dokumentumokat keres, ahol a LastRenovationDate mező nagyobb vagy egyenlő 2015. január 1. éjfélkor (UTC):

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

Olyan dokumentumokhoz illeszkedik, ahol a Details/Sku mező nem null:

Details/Sku ne null

Olyan szállodák dokumentumainak egyeztetése, ahol legalább egy szoba "Deluxe Szoba" típusú, ahol a Rooms/Type mező sztringje pontosan megfelel a szűrőnek:

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

Következő lépések

• Szűrők az Azure AI Keresésben
• Az Azure AI Keresés OData-kifejezési nyelvének áttekintése
• OData kifejezésszintaxis-referencia az Azure AI Keresés számára
• Dokumentumok keresése (Azure AI Keresés REST API)