Schnellstart: Verwenden des Suchexplorers zum Ausführen von Abfragen im PortalQuickstart: Use Search explorer to run queries in the portal

Der Suchexplorer ist ein integriertes Abfragetool, das zum Ausführen von Abfragen über einen Suchindex in Azure Cognitive Search verwendet wird.Search explorer is a built-in query tool used for running queries against a search index in Azure Cognitive Search. Mit diesem Tool können Sie problemlos Abfragesyntax erlernen, einen Abfrage- oder Filterausdruck testen oder eine Datenaktualisierung bestätigen, indem Sie überprüfen, ob neue Inhalte im Index vorhanden sind.This tool makes it easy to learn query syntax, test a query or filter expression, or confirm data refresh by checking whether new content exists in the index.

In diesem Schnellstart wird der Suchexplorer anhand eines vorhandenen Index veranschaulicht.This quickstart uses an existing index to demonstrate Search explorer. Anforderungen werden mit der Search-REST-API formuliert, und Antworten werden als JSON-Dokumente zurückgegeben.Requests are formulated using the Search REST API, with responses returned as JSON documents.

VoraussetzungenPrerequisites

Bevor Sie mit diesem Lernprogramm beginnen können, benötigen Sie Folgendes:Before you begin, you must have the following:

  • Ein Azure-Konto mit einem aktiven Abonnement.An Azure account with an active subscription. Sie können kostenlos ein Konto erstellen.Create an account for free.

  • Ein Azure Cognitive Search-Dienst.An Azure Cognitive Search service. Erstellen Sie einen Dienst, oder wechseln Sie in Ihrem aktuellen Abonnement zu einem vorhandenen Dienst.Create a service or find an existing service under your current subscription. Für diesen Schnellstart können Sie einen kostenlosen Dienst verwenden.You can use a free service for this quickstart.

  • realestate-us-sample-index wird für diesen Schnellstart verwendet.The realestate-us-sample-index is used for this quickstart. Verwenden Sie den Datenimport-Assistenten, um den Index zu erstellen.Use the Import data wizard to create the index. Wenn Sie im ersten Schritt nach der Datenquelle gefragt werden, wählen Sie Beispiele und dann die Datenquelle realestate-us-sample aus.In the first step, when asked for the data source, choose Samples and then select the realestate-us-sample data source. Übernehmen Sie zum Erstellen des Index alle Standardeinstellungen des Assistenten.Accept all of the wizard defaults to create the index.

Starten des SuchexplorersStart Search explorer

  1. Öffnen Sie im Azure-Portal im Dashboard die Seite mit dem Suchdienst, oder suchen Sie Ihren Dienst.In the Azure portal, open the search service page from the dashboard or find your service.

  2. Öffnen Sie den Suchexplorer über die Befehlsleiste:Open Search explorer from the command bar:

    Befehl für den Suchexplorer im PortalSearch explorer command in portal

    Oder verwenden Sie die eingebettete Registerkarte Suchexplorer in einem geöffneten Index:Or use the embedded Search explorer tab on an open index:

    Registerkarte „Suchexplorer“Search explorer tab

Abfrage ohne AngabeUnspecified query

Führen Sie für einen ersten Blick auf den Inhalt eine leere Suche aus, indem Sie ohne Angabe von Begriffen auf Suchen klicken.For a first look at content, execute an empty search by clicking Search with no terms provided. 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.An empty search is useful as a first query because it returns entire documents so that you can review document composition. Bei einer leeren Suche gibt es keinen Suchrang, und die Dokumente werden in beliebiger Reihenfolge ("@search.score": 1 für alle Dokumente) zurückgegeben.On an empty search, there is no search rank and documents are returned in arbitrary order ("@search.score": 1 for all documents). Standardmäßig werden in einer Suchanforderung 50 Dokumente zurückgegeben.By default, 50 documents are returned in a search request.

Die äquivalente Syntax für eine leere Suche ist * oder search=*.Equivalent syntax for an empty search is * or search=*.

search=*

ErgebnisseResults

Beispiel für eine leere AbfrageEmpty query example

Freiformabfragen mit oder ohne Operatoren sind nützlich zum Simulieren von benutzerdefinierten Abfragen, die von einer benutzerdefinierten App an die kognitive Azure-Suche gesendet werden.Free-form queries, with or without operators, are useful for simulating user-defined queries sent from a custom app to Azure Cognitive Search. Nur die Felder, die in der Indexdefinition als Durchsuchbar gekennzeichnet sind, werden auf Übereinstimmungen überprüft.Only those fields attributed as Searchable in the index definition are scanned for matches.

Beachten Sie, dass bei der Angabe von Suchkriterien wie z. B. Abfragebegriffen oder -ausdrücken der Suchrang eine Rolle spielt.Notice that when you provide search criteria, such as query terms or expressions, search rank comes into play. Im folgenden Beispiel wird eine Freitextsuche veranschaulicht.The following example illustrates a free text search.

Seattle apartment "Lake Washington" miele OR thermador appliance

ErgebnisseResults

Sie können die Ergebnisse mit STRG+F nach bestimmten Begriffen durchsuchen.You can use Ctrl-F to search within results for specific terms of interest.

Beispiel für FreitextabfrageFree text query example

Anzahl übereinstimmender DokumenteCount of matching documents

Fügen Sie $count=true hinzu, um die Anzahl der Übereinstimmungen in einem Index abzurufen.Add $count=true to get the number of matches found in an index. Bei einer leeren Suche ist die Anzahl die Gesamtanzahl der Dokumente im Index.On an empty search, count is the total number of documents in the index. Bei einer qualifizierten Suche ist es die Anzahl der Dokumente, die der eingegebenen Abfrage entsprechen.On a qualified search, it's the number of documents matching the query input.

$count=true

ErgebnisseResults

Beispiel für die Anzahl der DokumenteCount of documents example

Beschränken der Felder in den SuchergebnissenLimit fields in search results

Fügen Sie $select hinzu, um die Ergebnisse auf die explizit benannten Felder zu beschränken und damit die Lesbarkeit der Ausgabe im Suchexplorer zu erhöhen.Add $select to limit results to the explicitly named fields for more readable output in Search explorer. Um die Suchzeichenfolge und $count=true beizubehalten, stellen Sie den Argumenten das Präfix & voran.To keep the search string and $count=true, prefix arguments with &.

search=seattle condo&$select=listingId,beds,baths,description,street,city,price&$count=true

ErgebnisseResults

Beispiel für das Beschränken der FelderLimit fields example

Zurückgeben des nächsten Batches von ErgebnissenReturn next batch of results

Die kognitive Azure-Suche gibt die ersten 50 Übereinstimmungen basierend auf dem Suchrang zurück.Azure Cognitive Search returns the top 50 matches based on the search rank. Um den nächsten Satz von übereinstimmenden Dokumenten abzurufen, fügen Sie $top=100,&$skip=50 an, um das Resultset auf 100 Dokumente zu vergrößern (Standardwert 50, Höchstwert 1.000) und die ersten 50 Dokumente zu überspringen.To get the next set of matching documents, append $top=100,&$skip=50 to increase the result set to 100 documents (default is 50, maximum is 1000), skipping the first 50 documents. Denken Sie daran, dass Sie Suchkriterien angeben müssen, z.B. einen Abfragebegriff oder -ausdruck, um priorisierte Ergebnisse zu erhalten.Recall that you need to provide search criteria, such as a query term or expression, to get ranked results. Beachten Sie, dass sich die Suchbewertungen verringern, je weiter Sie in die Suchergebnisse vordringen.Notice that search scores decrease the deeper you reach into search results.

search=seattle condo&$select=listingId,beds,baths,description,street,city,price&$count=true&$top=100&$skip=50

ErgebnisseResults

BatchsuchergebnisseBatch search results

Filterausdrücke (größer als, kleiner als, gleich)Filter expressions (greater than, less than, equal to)

Verwenden Sie den Parameter $filter, wenn Sie anstelle einer Freitextsuche präzise Kriterien angeben möchten.Use the $filter parameter when you want to specify precise criteria rather than free text search. Das Feld muss im Index als Filterbar gekennzeichnet sein.The field must be attributed as Filterable in the index. In diesem Beispiel wird für die Anzahl von Schlafzimmern nach einem Wert größer als 3 gesucht:This example searches for bedrooms greater than 3:

search=seattle condo&$filter=beds gt 3&$count=true

ErgebnisseResults

FilterausdruckFilter expression

SortierausdrückeOrder-by expressions

Fügen Sie $orderby hinzu, um die Ergebnisse nach einem anderen Feld als der Suchbewertung zu sortieren.Add $orderby to sort results by another field besides search score. Das Feld muss im Index als Sortierbar gekennzeichnet sein.The field must be attributed as Sortable in the index. Als Beispielausdruck zum Testen können Sie den folgenden verwenden:An example expression you can use to test this out is:

search=seattle condo&$select=listingId,beds,price&$filter=beds gt 3&$count=true&$orderby=price asc

ErgebnisseResults

orderby-AusdruckOrderby expression

Die Ausdrücke $filter und $orderby sind OData-Konstrukte.Both $filter and $orderby expressions are OData constructions. Weitere Informationen finden Sie unter OData Expression Syntax for Azure Search (OData-Ausdruckssyntax für Azure Search).For more information, see Filter OData syntax.

Wesentliche PunkteTakeaways

In diesem Schnellstart haben Sie den Suchexplorer verwendet, um einen Index mithilfe der REST-API abzufragen.In this quickstart, you used Search explorer to query an index using the REST API.

  • Ergebnisse werden als ausführliche JSON-Dokumente zurückgegeben, sodass Sie den Dokumentaufbau und den Inhalt vollständig anzeigen können.Results are returned as verbose JSON documents so that you can view document construction and content, in entirety. Sie können in den Beispielen gezeigte Abfrageausdrücke verwenden, um die zurückgegebenen Felder einzuschränken.You can use query expressions, shown in the examples, to limit which fields are returned.

  • Dokumente bestehen aus allen Feldern, die im Index als abrufbar gekennzeichnet sind.Documents are composed of all fields marked as Retrievable in the index. Klicken Sie zum Anzeigen von Indexattributen im Portal auf der Übersichtsseite der Suche in der Liste Indizes auf realestate-us-sample.To view index attributes in the portal, click realestate-us-sample in the Indexes list on the search overview page.

  • Freiformabfragen ähneln der Eingabe in kommerziellen Webbrowsern und eignen sich zum Testen der Endbenutzererfahrung.Free-form queries, similar to what you might enter in a commercial web browser, are useful for testing an end-user experience. Beim integrierten Beispielimmobilienindex könnten Sie z.B. „Seattle apartments lake washington“ eingeben und dann mit STRG+F Begriffe in den Suchergebnissen finden.For example, assuming the built-in realestate sample index, you could enter "Seattle apartments lake washington", and then you can use Ctrl-F to find terms within the search results.

  • Abfrage- und Filterausdrücke werden in einer Syntax formuliert, die von Azure Cognitive Search unterstützt wird.Query and filter expressions are articulated in a syntax supported by Azure Cognitive Search. Der Standardwert ist eine einfache Syntax, Sie können aber optional für leistungsstarke Abfragen die vollständige Lucene-Syntax verwenden.The default is a simple syntax, but you can optionally use full Lucene for more powerful queries. Filterausdrücke folgen einer OData-Syntax.Filter expressions are an OData syntax.

Bereinigen von RessourcenClean up resources

Wenn Sie in Ihrem eigenen Abonnement arbeiten, sollten Sie sich am Ende eines Projekts überlegen, ob Sie die erstellten Ressourcen noch benötigen.When you're working in your own subscription, it's a good idea at the end of a project to identify whether you still need the resources you created. Ressourcen, die weiterhin ausgeführt werden, können Sie Geld kosten.Resources left running can cost you money. Sie können entweder einzelne Ressourcen oder aber die Ressourcengruppe löschen, um den gesamten Ressourcensatz zu entfernen.You can delete resources individually or delete the resource group to delete the entire set of resources.

Ressourcen können im Portal über den Link Alle Ressourcen oder Ressourcengruppen im linken Navigationsbereich gesucht und verwaltet werden.You can find and manage resources in the portal, using the All resources or Resource groups link in the left-navigation pane.

Denken Sie bei Verwendung eines kostenlosen Diensts an die Beschränkung auf maximal drei Indizes, Indexer und Datenquellen.If you are using a free service, remember that you are limited to three indexes, indexers, and data sources. Sie können einzelne Elemente über das Portal löschen, um unter dem Limit zu bleiben.You can delete individual items in the portal to stay under the limit.

Nächste SchritteNext steps

Um mehr über Abfragestrukturen und -syntax zu erfahren, verwenden Sie Postman oder ein gleichwertiges Tool, um Abfrageausdrücke zu erstellen, die mehr Teile der API nutzen.To learn more about query structures and syntax, use Postman or an equivalent tool to create query expressions that leverage more parts of the API. Die Search-REST-API ist besonders hilfreich für das Lernen und Erkunden.The Search REST API is especially helpful for learning and exploration.