OData-Sammlungsoperatoren in Foundry IQ (Azure KI-Suche) - any undall

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.

Beim Schreiben eines OData-Filterausdrucks, der mit Foundry IQ (Azure KI-Suche) verwendet werden soll, ist es häufig nützlich, nach Sammlungsfeldern zu filtern. Dies können dies mit den Operatoren any und all erreichen.

Syntax

Die folgende EBNF (Erweiterte Backus-Naur-Form) definiert die Grammatik eines OData-Ausdrucks, der any oder all verwendet.

collection_filter_expression ::=
    field_path'/all(' lambda_expression ')'
    | field_path'/any(' lambda_expression ')'
    | field_path'/any()'

lambda_expression ::= identifier ':' 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 drei Formen von Ausdrücken, die Sammlungen filtern.

  • Die ersten beiden iterieren über ein Sammlungsfeld und wenden ein Prädikat in Form eines Lambdaausdrucks auf jedes Element der Sammlung an.
    • Ein Ausdruck, der all verwendet, gibt true zurück, wenn das Prädikat für jedes Element der Sammlung TRUE ist.
    • Ein Ausdruck, der any verwendet, gibt true zurück, wenn das Prädikat für mindestens ein Element der Sammlung TRUE ist.
  • Die dritte Form von Sammlungsfilter verwendet any ohne einen Lambdaausdruck, um zu testen, ob ein Sammlungsfeld leer ist. Wenn die Sammlung über Elemente verfügt, wird true zurückgegeben. Wenn die Sammlung leer ist, wird false zurückgegeben.

Ein Lambdaausdruck in einem Filter für Sammlungen ist wie der Rumpf einer Schleife in einer Programmiersprache. Er definiert eine Variable, die als Bereichsvariable bezeichnet wird und das aktuelle Element der Sammlung während der Iteration enthält. Er definiert auch einen weiteren booleschen Ausdruck, der die Filterkriterien darstellt, die auf die Bereichsvariable für jedes Element der Sammlung angewendet werden sollen.

Beispiele

Abgleichen von Dokumenten, deren tags-Feld die genaue Zeichenfolge „wifi“ enthält:

tags/any(t: t eq 'wifi')

Abgleichen von Dokumenten, in denen jedes Element des ratings-Felds zwischen 3 und 5 (einschließlich) liegt:

ratings/all(r: r ge 3 and r le 5)

Abgleichen von Dokumenten, in denen jede der Geokoordinaten im locations-Feld im angegebenen Polygon liegt:

locations/any(loc: geo.intersects(loc, geography'POLYGON((-122.031577 47.578581, -122.031577 47.678581, -122.131577 47.678581, -122.031577 47.578581))'))

Abgleichen von Dokumenten, bei denen das rooms-Feld leer ist:

not rooms/any()

Abgleichen von Dokumenten, in denen das rooms/amenities-Feld für alle Räume „tv“ enthält und rooms/baseRate kleiner als 100 ist:

rooms/all(room: room/amenities/any(a: a eq 'tv') and room/baseRate lt 100.0)

Begrenzungen

Nicht jedes Merkmal von Filterausdrücken ist innerhalb des Textkörpers eines Lambdaausdrucks verfügbar. Die unterschiedlichen Einschränkungen hängen vom Datentyp des Sammlungsfelds ab, nach dem Sie filtern möchten. Die Einschränkungen werden in der folgenden Tabelle zusammengefasst.

Datentyp Features, die in Lambdaausdrücken mit any zulässig sind Features, die in Lambdaausdrücken mit all zulässig sind
Collection(Edm.ComplexType) Alles mit Ausnahme von search.ismatch und search.ismatchscoring identisch
Collection(Edm.String) Vergleiche mit eq oder search.in

Kombinieren von Unterausdrücken mit or
Vergleiche mit ne oder not search.in()

Kombinieren von Unterausdrücken mit and
Collection(Edm.Boolean) Vergleiche mit eq oder ne identisch
Collection(Edm.GeographyPoint) Verwenden von geo.distance mit lt oder le

geo.intersects

Kombinieren von Unterausdrücken mit or
Verwenden von geo.distance mit gt oder ge

not geo.intersects(...)

Kombinieren von Unterausdrücken mit and
Collection(Edm.DateTimeOffset), Collection(Edm.Double), Collection(Edm.Int32), Collection(Edm.Int64) Vergleiche mit eq, ne, lt, gt, le oder ge

Kombinieren von Vergleichen mit anderen Unterausdrücken mithilfe von or

Kombinieren von Vergleichen, ausgenommen ne, mit anderen Unterausdrücken mithilfe von and

Ausdrücke über Kombinationen von and und or in disjunktiver Normalform (DNF)
Vergleiche mit eq, ne, lt, gt, le oder ge

Kombinieren von Vergleichen mit anderen Unterausdrücken mithilfe von and

Kombinieren von Vergleichen, ausgenommen eq, mit anderen Unterausdrücken mithilfe von or

Ausdrücke über Kombinationen von and und or in konjunktiver Normalform (KNF)

Weitere Informationen zu diesen Einschränkungen sowie Beispielen finden Sie unter Problembehandlung von Sammlungsfiltern in Foundry IQ. Ausführlichere Informationen dazu, warum diese Einschränkungen bestehen, finden Sie unter Informationen zu Sammlungsfiltern in Foundry IQ.

Nächste Schritte