Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Logische OData-Operatoren in Foundry IQ (Azure KI-Suche) -
Hinweis
Foundry IQ (Azure KI-Suche) bietet direkte Indizierungs- und Abfrage-APIs zusammen mit Wissensquellen- und Knowledge Base-APIs auf höherer Ebene für den verwalteten Abruf. Verwenden Sie das Azure Portal, REST-APIs oder Azure SDKs, um diese Funktionen zu konfigurieren, oder verbinden Sie Agents mit Wissensdatenbanken im Microsoft Foundry-Portal.
OData-Filterausdrücke in Foundry IQ (Azure KI-Suche) sind boolesche Ausdrücke, die zu true oder false ausgewertet werden. Sie können einen komplexen Filter schreiben, indem Sie eine Reihe von einfacheren Filtern erstellen und diese dann mit den logischen Operatoren aus boolescher Algebra zusammensetzen:
-
and: Ein binärer Operator, der zutrueausgewertet wird, wenn sowohl sein linker als auch sein rechter Unterausdruck zutrueausgewertet wird. -
or: Ein binärer Operator, der zutrueausgewertet wird, wenn entweder sein linker oder rechter Unterausdruck zutrueausgewertet wird. -
not: Ein unärer Operator, der zutrueausgewertet wird, wenn sein Unterausdruck zufalseausgewertet wird, und umgekehrt.
Diese Operatoren ermöglichen es Ihnen zusammen mit den Sammlungsoperatorenany und all, Filter zu erstellen, die sehr komplexe Suchkriterien ausdrücken können.
Syntax
Die folgende EBNF (Erweiterte Backus-Naur-Form) definiert die Grammatik eines OData-Ausdrucks, der die logischen Operatoren verwendet.
logical_expression ::=
boolean_expression ('and' | 'or') boolean_expression
| 'not' boolean_expression
Ein interaktives Syntaxdiagramm ist ebenfalls verfügbar:
Hinweis
Siehe OData-Ausdruckssyntaxreferenz für Foundry IQ für das vollständige EBNF.
Es gibt zwei Formen von logischen Ausdrücken: binär (and/or) mit zwei Unterausdrücken und unär (not) mit nur einem Unterausdruck. Die Unterausdrücke können beliebige boolesche Ausdrücke sein:
- Felder oder Bereichsvariablen vom Typ
Edm.Boolean - Funktionen, die Werte vom Typ
Edm.Booleanzurückgeben, z.B.geo.intersectsodersearch.ismatch -
Vergleichsausdrücke, z. B.
rating gt 4 -
Sammlungsausdrücke, z. B.
Rooms/any(room: room/Type eq 'Deluxe Room') - Die booleschen Literale
trueoderfalse. - Andere logische Ausdrücke, die mit
and,orodernotgebildet werden.
Wichtig
Unter bestimmten Umständen können nicht alle Arten von Unterausdrücken mit and/or verwendet werden, insbesondere innerhalb von Lambdaausdrücken. Details finden Sie unter OData-Sammlungsoperatoren in Foundry IQ .
Logische Operatoren und null
Die meisten booleschen Ausdrücke wie Funktionen und Vergleiche können keine null-Werte erzeugen, und die logischen Operatoren können nicht direkt auf das null-Literal angewendet werden (z.B. ist x and null unzulässig). Boolesche Felder können jedoch null sein, sodass Sie beachten müssen, wie sich die Operatoren and, or und not bei Vorhandensein von null verhalten. Dies wird in der folgenden Tabelle zusammengefasst, wobei b ein Feld vom Typ Edm.Boolean ist:
| Ausdruck | Ergebnis, wenn der Wert bnull ist |
|---|---|
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 |
Wenn ein boolesches Feld b von selbst in einem Filterausdruck vorkommt, verhält es sich, als wäre es b eq true. Wenn also bnull ist, wird der Ausdruck in false ausgewertet. Auf ähnliche Weise verhält sich not b wie not (b eq true) und wird daher in true ausgewertet. Auf diese Weise verhalten sich null-Felder wie false. Dies entspricht dem Verhalten bei der Kombination mit anderen Ausdrücken unter Verwendung von and und or, wie in der Tabelle oben gezeigt. Dennoch wird ein direkter Vergleich mit false (b eq false) immer noch in false ausgewertet. Mit anderen Worten: null ist nicht gleich false, auch wenn es sich in booleschen Ausdrücken so verhält.
Beispiele
Abgleichen von Dokumenten, bei denen das rating-Feld zwischen 3 und 5 (einschließlich) liegt:
rating ge 3 and rating le 5
Abgleichen von Dokumenten, bei denen alle Elemente des ratings-Felds kleiner als 3 oder größer als 5 sind:
ratings/all(r: r lt 3 or r gt 5)
Abgleichen von Dokumenten, bei denen das location-Feld im angegebenen Polygon liegt und das Dokument nicht den Begriff „public“ (öffentlich) enthält.
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')
Abgleichen von Dokumenten für Hotels in Vancouver (Kanada), die ein Luxuszimmer mit einem Basispreis kleiner als 160 bieten:
Address/City eq 'Vancouver' and Address/Country eq 'Canada' and Rooms/any(room: room/Type eq 'Deluxe Room' and room/BaseRate lt 160)