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.
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.
Dieser Artikel enthält Hintergrundinformationen für Entwickler, die erweiterte Filter mit komplexen Lambda-Ausdrücken schreiben. In diesem Artikel wird erläutert, warum die Regeln für Sammlungsfilter vorhanden sind, indem untersucht wird, wie Foundry IQ (Azure KI-Suche) diese Filter ausführt.
Wenn Sie einen Filter für Sammlungsfelder in Foundry IQ erstellen, können Sie die any Und-Operatoren all zusammen mit Lambda-Ausdrücken verwenden. Lambdaausdrücke sind boolesche Ausdrücke, die auf eine Bereichsvariable verweisen. In Filtern, die einen Lambda-Ausdruck verwenden, sind die Operatoren any und all analog zu einer for-Schleife in den meisten Programmiersprachen, wobei die Bereichsvariable die Rolle der Schleifenvariablen übernimmt und der Lambda-Ausdruck als der Schleifenkörper fungiert. Die Bereichsvariable nimmt während der Iteration der Schleife den "aktuellen" Wert der Sammlung an.
Zumindest funktioniert es so theoretisch. Tatsächlich implementiert Foundry IQ Filter auf eine ganz andere Art und Weise, wie for Schleifen funktionieren. Im Idealfall wäre dieser Unterschied für Sie unsichtbar, aber unter bestimmten Umständen ist er es nicht. Das Endergebnis ist, dass es Regeln gibt, denen Sie beim Schreiben von Lambdaausdrücken folgen müssen.
Hinweis
Informationen dazu, was die Regeln für Sammlungsfilter sind, einschließlich Beispiele, finden Sie unter Problembehandlung von OData-Auflistungsfiltern in Foundry IQ.
Warum Sammlungsfilter eingeschränkt sind
Es gibt drei Hauptgründe, warum nicht alle Filterfunktionen für alle Arten von Sammlungen unterstützt werden:
- Nur bestimmte Operatoren werden für bestimmte Datentypen unterstützt. Beispielsweise ist es nicht sinnvoll, die Booleschen Werte
trueundfalsemit Vergleichsoperatoren wieltundgtzu vergleichen. - Foundry IQ unterstützt korrelierte Filter auf Feldern des Typs
Collection(Edm.ComplexType), aber die feldbasierte Volltextsuche über diese Felder ist nicht korreliert. - Foundry IQ verwendet invertierte Indizes, um Filter über alle Arten von Daten auszuführen, einschließlich Sammlungen.
Der erste Grund ist nur eine Folge der Definition der OData-Sprache und des EDM-Typsystems. Die letzten beiden Gründe werden im weiteren Verlauf dieses Artikels näher erläutert.
Korrelierte Suche im Vergleich zu nicht korrelierter Suche
Wenn mehrere Filterkriterien auf eine Sammlung komplexer Objekte angewendet werden, sind die Kriterien korreliert, da sie sich auf jedes Objekt in der Sammlung beziehen. Der folgende Filter gibt beispielsweise Hotels zurück, die mindestens ein Luxuszimmer mit einem Preis von weniger als 100 haben:
Rooms/any(room: room/Type eq 'Deluxe Room' and room/BaseRate lt 100)
Wenn die Filterung unkorreliert wäre, kann der obige Filter Hotels zurückgeben, in denen ein Zimmer deluxe ist und ein anderes Zimmer einen Basispreis von weniger als 100 hat. Das wäre nicht sinnvoll, da beide Klauseln des Lambdaausdrucks für die gleiche Bereichsvariable gelten, nämlich für room. Aus diesem Grund sind solche Filter korreliert.
Bei der Volltextsuche gibt es jedoch keine Möglichkeit, auf eine bestimmte Bereichsvariable zu verweisen. Wenn Sie die feldbezogene Suche verwenden, um eine vollständige Lucene-Abfrage wie diese auszugeben:
Rooms/Type:deluxe AND Rooms/Description:"city view"
erhalten Sie möglicherweise Hotels zurück, in denen ein Zimmer deluxe ist und für ein anderes Zimmer „city view“ (Aussicht auf die Stadt) in der Beschreibung erwähnt wird. Beispielsweise würde das folgende Dokument mit Id von 1 der Suchanfrage entsprechen.
{
"value": [
{
"Id": "1",
"Rooms": [
{ "Type": "deluxe", "Description": "Large garden view suite" },
{ "Type": "standard", "Description": "Standard city view room" }
]
},
{
"Id": "2",
"Rooms": [
{ "Type": "deluxe", "Description": "Courtyard motel room" }
]
}
]
}
Der Grund dafür ist, dass Rooms/Type sich auf alle analysierten Begriffe des Felds Rooms/Type im gesamten Dokument und ähnlich für Rooms/Description bezieht, wie in den folgenden Tabellen gezeigt.
So wird Rooms/Type für die Volltextsuche gespeichert:
Begriff in Rooms/Type |
Dokument-IDs |
|---|---|
| deluxe | 1, 2 |
| Standard | 1 |
So wird Rooms/Description für die Volltextsuche gespeichert:
Begriff in Rooms/Description |
Dokument-IDs |
|---|---|
| Innenhof | 2 |
| Stadt | 1 |
| Garten | 1 |
| groß | 1 |
| Motel | 2 |
| room | 1, 2 |
| Standard | 1 |
| Suite | 1 |
| Ansicht | 1 |
Im Gegensatz zum obigen Filter, der im Wesentlichen besagt, dass „Dokumente ermittelt werden sollen, in denen Type für ein Zimmer gleich „Deluxe Room“ (Luxuszimmer) und für BaseRate kleiner als 100 ist“, besagt die Suchabfrage, dass „Dokumente ermittelt werden sollen, in denen Rooms/Type den Begriff „deluxe“ und Rooms/Description den Begriff „city view“ (Aussicht auf die Stadt) enthält. Es gibt kein Konzept für einzelne Zimmer, deren Felder im letzteren Fall korreliert werden können.
Invertierte Indizes und Sammlungen
Möglicherweise stellen Sie fest, dass Lambda-Ausdrücke bei komplexen Sammlungen weit weniger Einschränkungen unterliegen als bei einfachen Sammlungen wie Collection(Edm.Int32) und Collection(Edm.GeographyPoint). Dieser Unterschied besteht, da Foundry IQ komplexe Sammlungen als tatsächliche Sammlungen von Filialdokumenten speichert, während einfache Sammlungen überhaupt nicht als Sammlungen gespeichert werden.
Betrachten Sie beispielsweise ein filterbares Zeichenfolgen-Sammlungsfeld wie seasons in einem Index für einen Onlinehändler. Einige in diesen Index hochgeladene Dokumente könnten wie folgt aussehen:
{
"value": [
{
"id": "1",
"name": "Hiking boots",
"seasons": ["spring", "summer", "fall"]
},
{
"id": "2",
"name": "Rain jacket",
"seasons": ["spring", "fall", "winter"]
},
{
"id": "3",
"name": "Parka",
"seasons": ["winter"]
}
]
}
Die Werte des Felds seasons werden in einer Struktur namens invertierter Index gespeichert, die in etwa so aussieht:
| Begriff | Dokument-IDs |
|---|---|
| spring | 1, 2 |
| Sommer | 1 |
| fall | 1, 2 |
| winter | 2, 3 |
Diese Datenstruktur dient der schnellen Beantwortung der Frage: In welchen Dokumenten ist ein bestimmter Begriff vorhanden? Die Beantwortung dieser Frage funktioniert eher wie eine einfache Gleichheitsprüfung als ein Durchlaufen einer Sammlung. Für Zeichenfolgenauflistungen lässt eq Foundry IQ in der Tat nur als Vergleichsoperator innerhalb eines Lambda-Ausdrucks zu any.
Als Nächstes untersuchen wir, wie mehrere Gleichheitsprüfungen für dieselbe Bereichsvariable mit or kombiniert werden können. Dies funktioniert dank Algebra und der distributiven Eigenschaft von Quantifizierern. Der folgende Ausdruck:
seasons/any(s: s eq 'winter' or s eq 'fall')
entspricht:
seasons/any(s: s eq 'winter') or seasons/any(s: s eq 'fall')
und jeder der beiden any-Unterausdrücke kann effizient mithilfe des invertierten Index ausgeführt werden. Dank dem Negationsgesetz von Quantifizierern ist auch dieser Ausdruck:
seasons/all(s: s ne 'winter' and s ne 'fall')
entspricht:
not seasons/any(s: s eq 'winter' or s eq 'fall')
Deshalb ist es möglich, all mit ne und and zu verwenden.
Hinweis
Obwohl die Details über den Rahmen dieses Dokuments hinausgehen, erstrecken sich diese Prinzipien auch auf Abstands- und Überschneidungstests für Sammlungen von räumlichen Punkten. Deshalb kann in any:
-
geo.intersectsKann nicht negiert werden -
geo.distancemuss mitltoderleverglichen werden - Ausdrücke müssen mit
orund nicht mitandkombiniert werden
Die entgegengesetzten Regeln gelten für all.
Eine größere Vielfalt von Ausdrücken ist zulässig, wenn Sie nach Sammlungen von Datentypen filtern, die die Operatoren lt, gt, le und ge unterstützen, z.B. Collection(Edm.Int32). Insbesondere können Sie sowohl and als auch or in any verwenden, solange die zugrunde liegenden Vergleichsausdrücke zu Bereichsvergleichen mit and kombiniert werden, die dann mit or weiter kombiniert werden. Diese Struktur von booleschen Ausdrücken wird als disjunktive Normalform (DNF) bezeichnet, auch bekannt als „ORs of ANDs“. Im Gegensatz dazu müssen Lambdaausdrücke für all für diese Datentypen in konjunktiver Normalform (CNF) vorliegen, auch bekannt als „ANDs of ORs“. Foundry IQ ermöglicht solche Bereichsvergleiche, da Foundry IQ sie mithilfe von invertierten Indizes effizient ausführen kann, genau wie bei der schnellen Begriffssuche für Zeichenfolgen.
Zusammenfassend sind dies die Faustregeln für das, was in einem Lambdaausdruck zulässig ist:
- Innerhalb von
anysind positive Überprüfungen immer zulässig, etwa Gleichheit, Bereichsvergleiche,geo.intersectsodergeo.distanceim Vergleich zultoderle(sehen Sie „Nähe“ als Gleichheit an, wenn es um die Überprüfung der Entfernung geht). - In
anyistorimmer zulässig. Sie könnenandnur für Datentypen verwenden, die Bereichsüberprüfungen ausdrücken können, und nur dann, wenn Sie ORs aus ANDs (DNF) verwenden. - Innerhalb
allwerden die Regeln umgekehrt. Nur negative Prüfungen sind zulässig. Sie könnenandimmer verwenden. Sie könnenornur für Bereichsprüfungen verwenden, die als ANDs von ORs (CNF) ausgedrückt werden.
In der Praxis sind dies die Arten von Filtern, die Sie ohnehin am ehesten verwenden werden. Es ist trotzdem hilfreich, die Grenzen dessen zu verstehen, was möglich ist.
Spezifische Beispiele dafür, welche Arten von Filtern zulässig sind und welche nicht, finden Sie unter Schreiben gültiger Sammlungsfilter.