Abfragen in Azure KI Search

Azure KI Search unterstützt Abfragekonstrukte für eine breite Palette von Szenarien, von der Freiformtextsuche, über sehr spezifische Abfragemuster bis hin zur Vektorsuche. Alle Abfragen werden über einen Suchindex ausgeführt, der suchbare Inhalte speichert.

Abfragetypen

In diesem Artikel wird der Fokus auf die letzte Kategorie gelegt: Abfragen, die bei Klartextinhalten und alphanumerischen Inhalten funktionieren, aus der ursprünglichen Quelle extrahiert und für Filter und andere spezielle Abfrageformulare verwendet werden.

AutoVervollständigen und vorgeschlagene Abfragen

AutoVervollständigen und Vorschläge sind Alternativen zu search, die in Funktionen zur Suche während der Eingabe mehrere aufeinander folgende Abfrageanforderungen basierend auf eingegebenen Teilzeichenfolgen (nach jedem Zeichen) auslösen. Sie können die Parameter autocomplete und suggestions gemeinsam oder separat verwenden, wie in dieser Anleitung beschrieben. Die Verwendung mit search ist allerdings nicht möglich. Sowohl automatisch vervollständigte Begriffe als auch vorgeschlagene Abfragen werden aus dem Indexinhalt abgeleitet. Das Modul gibt niemals eine Zeichenfolge oder einen Vorschlag zurück, der in Ihrem Index nicht vorhanden ist. Weitere Informationen finden Sie unter AutoVervollständigen (REST-API) und Vorschläge (REST-API).

Filtern der Suche

Filter werden häufig in Apps verwendet, die auf Azure KI Search basieren. Auf Anwendungsseiten werden Filter oft als Facetten in Linknavigationsstrukturen dargestellt, sodass Benutzer die Filterung steuern können. Filter werden auch intern verwendet, um Slices der indizierten Inhalte verfügbar zu machen. Beispielsweise können Sie eine Suchseite mithilfe eines auf eine Produktkategorie festgelegten Filters initialisieren oder einen Sprachfilter verwenden, wenn ein Index Felder sowohl in englischer als auch in französischer Sprache enthält.

Möglicherweise benötigen Sie auch Filter, um ein spezielles Abfrageformular aufzurufen, wie in der folgenden Tabelle beschrieben. Sie können einen Filter mit einer nicht spezifizierten Suche (search=*) oder mit einer Abfragezeichenfolge verwenden, die Begriffe, Ausdrücke, Operatoren und Muster umfasst.

Geosuche

Die Geosuche gleicht anhand der Breiten- und Längenkoordinaten eines Standorts für „In meiner Nähe suchen“ oder einer kartenbasierte Suchoberfläche ab. In Azure KI Search können Sie die Geosuche implementieren, indem Sie die folgenden Schritte ausführen:

• Definieren Sie ein filterbares Feld eines der folgenden Typen: Edm.GeographyPoint, Collection(Edm.GeographyPoint, Edm.GeographyPolygon).
• Überprüfen Sie, ob die eingehenden Dokumente die entsprechenden Koordinaten enthalten.
• Erstellen Sie nach Abschluss der Indizierung eine Abfrage, die einen Filter und eine Geofunktion verwendet.

Die Geosuche verwendet Kilometer für die Entfernung. Koordinaten werden in diesem Format angegeben: (longitude, latitude).

Hier ist ein Beispiel für einen Filter für die Geosuche. Dieser Filter findet andere Location Felder im Suchindex, die Koordinaten innerhalb eines Radius von 300 Kilometern des geografischen Punkts haben (in diesem Beispiel Washington D.C.). Er gibt Adressinformationen im Ergebnis zurück und enthält eine optionale facets Klausel für die Selbstnavigation basierend auf der Position.

POST https://{{searchServiceName}}.search.windows.net/indexes/hotels-vector-quickstart/docs/search?api-version=2024-07-01
{
    "count": true,
    "search": "*",
    "filter": "geo.distance(Location, geography'POINT(-77.03241 38.90166)') le 300",
    "facets": [ "Address/StateProvince"],
    "select": "HotelId, HotelName, Address/StreetAddress, Address/City, Address/StateProvince",
    "top": 7
}

Weitere Informationen und Beispiele finden Sie unter Beispiel: Geosuche.

Dokumentsuche

Im Gegensatz zu den bisher beschriebenen Abfrageformen wird hier ein einzelnes Suchdokument anhand der ID abgerufen, ohne entsprechende Indexsuche oder -überprüfung. Es wird nur dieses eine Dokument angefordert und zurückgegeben. Wenn ein Benutzer in Suchergebnissen ein Element auswählt, besteht die typische Antwort darin, dass das Dokument abgerufen und die Detailseite mit Feldern aufgefüllt wird. Die Dokumentsuche ist der Vorgang, der diesen Fall unterstützt.

Erweiterte Suche: Fuzzy, Platzhalter, Näherung, regulärer Ausdruck

Ein erweitertes Abfrageformular benötigt die vollständige Version des Lucene-Parsers sowie Operatoren, die ein bestimmtes Abfrageverhalten auslösen.

Nächste Schritte

Genauere Informationen zur Implementierung der Abfrage finden Sie in den Beispielen für die jeweilige Syntax. Wenn Sie noch nicht mit der Volltextsuche gearbeitet haben, sollten Sie sich auch genauer ansehen, wie die Abfrage-Engine funktioniert.

• Aufrufen der einfachen Abfrageanalyse
• Beispiele für die Lucene-Abfragesyntax zum Erstellen von Abfragen in Azure Search
• Funktionsweise der Volltextsuche in Azure KI Searchgit