Schnellstart: Verwenden des Suchexplorers zum Ausführen von Abfragen im Azure-Portal

In dieser Schnellstartanleitung erfahren Sie, wie Sie den Such-Explorer verwenden, ein integriertes Abfragetool im Azure-Portal zum Ausführen von Abfragen für einen Azure AI Search-Index. Verwenden Sie dieses Tool, um einen Abfrage- oder Filterausdruck zu testen oder zu überprüfen, ob Inhalt im Index vorhanden ist.

In diesem Schnellstart wird der Suchexplorer anhand eines vorhandenen Index veranschaulicht.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.

• Ein Azure KI-Suche-Dienst. Erstellen Sie einen Dienst , oder suchen Sie einen vorhandenen Dienst in Ihrem aktuellen Abonnement. Für diese Schnellstartanleitung können Sie einen kostenlosen Dienst verwenden.

• In dieser Schnellstartanleitung wird der Beispielindex für Hotels verwendet. Folgen Sie den Anweisungen in dieser Schnellstartanleitung , um den Index zu erstellen.

Starten des Suchexplorers

1. Melden Sie sich beim Azure-Portal an, und wählen Sie Ihren Suchdienst aus.

2. Wählen Sie im linken Bereich die Option "Übersicht" aus.

3. Wählen Sie auf der Befehlsleiste den Such-Explorer aus.

   

   Alternativ können Sie auf der Indexseite die Registerkarte "Such-Explorer " auswählen.

Drei Arten der Abfrage

Es gibt drei Ansätze zum Abfragen im Such-Explorer:

• In der Abfrageansicht steht standardmäßig eine Suchleiste zur Verfügung. Es akzeptiert eine leere Abfrage oder Freitextabfrage mit Booleschen Operatoren, z. B. ocean view + parking.

• Die Bildansicht bietet ein Fenster zum Durchsuchen oder Ablegen von PNG-, JPG- oder JPEG-Dateien. Sofern Ihr Index nicht über einen Bildvektorizer und eine entsprechende Fähigkeit verfügt, ist diese Ansicht nicht verfügbar.

• Die JSON-Ansicht unterstützt parametrisierte Abfragen. Filter, Reihenfolge, Auswahl, Anzahl, SearchFields und alle anderen Parameter müssen in der JSON-Ansicht festgelegt werden.

  

Beispiel: Bildabfrage

Der Such-Explorer akzeptiert Bilder als Abfrageeingaben über die Bildansicht, was erfordert, dass Sie ein unterstütztes Vektorisierer-Fähigkeitspaar verwenden. Weitere Informationen finden Sie unter Konfigurieren eines Vektorizers in einem Suchindex.

Der Hotels-Beispielindex ist nicht für die Bildvektorisierung konfiguriert. Wenn Sie Bildabfragen ausführen möchten, erstellen Sie einen Index, wie in der Schnellstartanleitung beschrieben: Vektorsuche im Azure-Portal. Die Schnellstartanleitung basiert auf textbasierten Beispieldaten, daher müssen Sie Dokumente verwenden, die Bilder enthalten.

Wenn Sie eine Bildabfrage ausführen möchten, wählen Sie ein Bild aus, oder ziehen Sie es in den Suchbereich, und wählen Sie dann "Suchen" aus. Der Such-Explorer vektorisiert das Bild und sendet den Vektor zur Abfrageausführung an die Suchmaschine. Die Suchmaschine gibt Dokumente zurück, die dem Eingabebild ausreichend ähnlich sind, bis zur angegebenen k Anzahl von Ergebnissen.

Beispiele: JSON-Abfragen

Im Folgenden finden Sie Beispiele für JSON-Abfragen, die Sie mit dem Such-Explorer ausführen können. Um diesen Beispielen zu folgen, wechseln Sie zur JSON-Ansicht. Sie können jedes JSON-Beispiel in den Textbereich einfügen.

Tipp

Die JSON-Ansicht unterstützt IntelliSense für den Abschluss des Parameternamens. Platzieren Sie den Cursor in der JSON-Ansicht, und geben Sie ein Leerzeichen ein, um eine Liste aller Abfrageparameter anzuzeigen. Sie können auch einen Buchstaben wie s eingeben, um nur die Abfrageparameter anzuzeigen, die mit diesem Buchstaben beginnen.

IntelliSense schließt ungültige Parameter nicht aus, verwenden Sie daher Ihr bestes Urteil.

Ausführen einer nicht angegebenen Abfrage

Im Suchexplorer werden POST-Anforderungen intern mit Dokumente – Search Post (REST-API) formuliert, und Antworten werden als ausführliche JSON-Dokumente zurückgegeben.

Führen Sie für einen ersten Blick auf Inhalte eine leere Suche aus, indem Sie "Suchen " ohne bereitgestellte Begriffe auswählen. Eine leere Suche ist eine sinnvolle erste Abfrage, da sie vollständige Dokumente zurückgibt, sodass Sie sich mit dem Aufbau des Dokuments vertraut machen können. Bei einer leeren Suche gibt es keine Suchbewertung, und Dokumente werden in beliebiger Reihenfolge ("@search.score": 1 für alle Dokumente) zurückgegeben. Standardmäßig werden 50 Dokumente pro Suchanforderung zurückgegeben.

Fügen Sie "count": true hinzu, um die Anzahl der Übereinstimmungen in einem Index abzurufen. Bei einer leeren Suche ist die Anzahl die Gesamtzahl der Dokumente im Index. Bei einer qualifizierten Suche ist es die Anzahl der Dokumente, die der eingegebenen Abfrage entsprechen. Denken Sie daran, dass der Dienst standardmäßig die höchsten 50 Übereinstimmungen zurückgibt, sodass die Anzahl möglicherweise mehr Übereinstimmungen im Index angibt, als in den Ergebnissen zurückgegeben wird.

Die äquivalente Syntax für eine leere Suche ist * oder "search": "*".

{
   "search": "*",
   "count": true
}

Ergebnisse

Ausführen einer Freitextabfrage

Die Freiformsuche mit oder ohne Operatoren ist nützlich, um benutzerdefinierte Abfragen zu simulieren, die von einer benutzerdefinierten App an Azure AI Search gesendet werden. Nur Felder, die im Index als durchsuchbar gekennzeichnet sind, werden nach Übereinstimmungen durchsucht.

Sie benötigen die JSON-Ansicht nicht für eine Freitextabfrage, aber wir stellen sie in JSON für Konsistenz mit anderen Beispielen in diesem Artikel bereit.

Beachten Sie, dass bei der Angabe von Suchkriterien wie z. B. Abfragebegriffen oder -ausdrücken der Suchrang eine Rolle spielt. Im folgenden Beispiel wird eine Freitextsuche veranschaulicht. @search.score ist eine Relevanzbewertung, die für die Übereinstimmung mit dem Standardbewertungsalgorithmus berechnet wird.

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast"
}

Ergebnisse

Sie können die Ergebnisse mit STRG+F nach bestimmten Begriffen durchsuchen.

Beschränken der Felder in den Suchergebnissen

Fügen Sie "select" hinzu, um Die Ergebnisse auf die explizit benannten Felder für eine besser lesbare Ausgabe im Such-Explorer zu beschränken. Nur Felder, die im Index als abrufbar zugeschrieben werden können, können in Ergebnissen angezeigt werden.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description"
}

Ergebnisse

Zurückgeben des nächsten Batches von Ergebnissen

Azure KI-Suche gibt die ersten 50 Übereinstimmungen basierend auf dem Suchrang zurück. Der Hotels-Beispielindex hat nur 50 Hotels, daher verwenden wir eine kleinere Anzahl, um das Paging zu veranschaulichen. Um den nächsten Satz übereinstimmender Dokumente abzurufen, fügen Sie "top": 20 und "skip": 10 hinzu, um die Ergebnismenge auf 20 Dokumente zu erhöhen (Standardwert ist 50, maximal 1000), und überspringen Sie die ersten 10 Dokumente. Sie können den Dokumentschlüssel (HotelId) überprüfen, um ein Dokument zu identifizieren.

Denken Sie daran, dass Sie Suchkriterien angeben müssen, z.B. einen Abfragebegriff oder -ausdruck, um priorisierte Ergebnisse zu erhalten. Suchbewertungen werden geringer, je weiter Sie in die Suchergebnisse vordringen.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description",
   "top": 20,
   "skip": 10
}

Ergebnisse

Filterausdrücke (größer als, kleiner als, gleich)

Verwenden Sie den filter Parameter, um Einschluss- oder Ausschlusskriterien anzugeben. Das Feld muss im Index als filterbar markiert werden. In diesem Beispiel wird nach Bewertungen gesucht, die größer als vier sind:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating",
    "filter": "Rating gt 4"
}

Ergebnisse

Ergebnisse sortieren

Fügen Sie orderby hinzu, um die Ergebnisse nach einem anderen Feld als der Suchbewertung zu sortieren. Das Feld muss als sortierbar im Index definiert werden. In Situationen, in denen der gefilterte Wert identisch ist (z. B. der gleiche Preis), ist die Reihenfolge beliebig, Sie können aber weitere Kriterien für eine tiefere Sortierung hinzufügen. Hier ist ein Beispielausdruck, den Sie zum Testen verwenden können:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
    "filter": "Rating gt 4",
    "orderby": "LastRenovationDate desc"
}

Ergebnisse

Wesentliche Punkte

In diesem Schnellstart haben Sie den Suchexplorer verwendet, um einen Index mithilfe der REST-API abzufragen.

• Ergebnisse werden als ausführliche JSON-Dokumente zurückgegeben, sodass Sie die Konstruktion und den Inhalt jedes Dokuments vollständig anzeigen können. Der select Parameter in einem Abfrageausdruck beschränkt, welche Felder zurückgegeben werden.

• Suchergebnisse bestehen aus allen Feldern, die im Index als abrufbar gekennzeichnet sind. Wählen Sie die Registerkarte "Felder " aus, um Attribute zu überprüfen.

• Die Stichwortsuche ist ähnlich wie die Eingabe in einem kommerziellen Webbrowser hilfreich, um eine Endbenutzererfahrung zu testen. Angenommen, Sie verwenden den Beispiel-Index für Hotels, können Sie "activities 'outdoor pool' restaurant OR continental breakfast" eingeben und dann Strg+F verwenden, um Begriffe in den Suchergebnissen zu finden.

• Abfrage- und Filterausdrücke werden in einer Syntax formuliert, die von Azure KI Search implementiert wird. Der Standardwert ist eine einfache Syntax, Sie können aber optional für leistungsstarke Abfragen die vollständige Lucene-Syntax verwenden. Filterausdrücke werden in einer OData-Syntax formuliert.

Bereinigen von Ressourcen

Wenn Sie in Ihrem eigenen Abonnement arbeiten, sollten Sie sich am Ende eines Projekts überlegen, ob Sie die erstellten Ressourcen noch benötigen. Ressourcen, die weiterhin ausgeführt werden, können Sie Geld kosten. Sie können entweder einzelne Ressourcen oder aber die Ressourcengruppe löschen, um den gesamten Ressourcensatz zu entfernen.

Im Azure-Portal können Sie Ressourcen suchen und verwalten, indem Sie im linken Bereich "Alle Ressourcen " oder "Ressourcengruppen " auswählen.

Denken Sie daran, dass ein kostenloser Suchdienst auf drei Indizes, drei Indexer und drei Datenquellen beschränkt ist. Um unter dem Grenzwert zu bleiben, können Sie diese Elemente einzeln im Azure-Portal löschen.

Nächster Schritt

Wenn Sie mehr über Abfragestrukturen und -syntax erfahren möchten, verwenden Sie einen REST-Client, um Abfrageausdrücke zu erstellen, die weitere Teile der REST-API verwenden. Documents - Search Post (REST API) ist besonders hilfreich für Lernen und Erkundung.

Schnellstart: Volltextsuche