Quickstart: Search Explorer gebruiken om query's uit te voeren in Azure Portal

  • Artikel

In deze quickstart leert u hoe u Search Explorer gebruikt, een ingebouwd queryprogramma in Azure Portal dat wordt gebruikt voor het uitvoeren van query's op een zoekindex in Azure AI Search. Gebruik deze om een query- of filterexpressie te testen of er inhoud in de index bestaat.

In deze quickstart wordt een bestaande index gebruikt om Search Explorer te demonstreren.

Vereisten

Voordat u begint, moet u beschikken over de volgende vereisten:

  • Een Azure-account met een actief abonnement. Gratis een account maken

  • Een Azure AI-Search-service. Maak een service of zoek een bestaande service in uw huidige abonnement. U kunt een gratis service voor deze quickstart gebruiken.

  • De realestate-us-sample-index wordt voor deze quickstart gebruikt. Als u de index wilt maken, gebruikt u de wizard Gegevens importeren, kiest u de ingebouwde voorbeeldgegevens en doorloopt u de wizard met behulp van alle standaardwaarden.

    Screenshot of the sample data sets available in the Import data wizard.

Start Search Explorer

  1. Open in Azure Portal, de pagina met het zoekoverzicht of zoek uw service.

  2. Open Search Explorer vanuit de opdrachtbalk:

    Screenshot of the Search explorer command in portal.

    Of gebruik het ingesloten tabblad Search Explorer in een geopende index:

    Screenshot of the Search explorer tab.

Query's uitvoeren op twee manieren

Er zijn twee methoden voor het uitvoeren van query's in Search Explorer.

  • De standaardzoekbalk accepteert een lege query of een vrije tekstquery met Booleaanse waarden. Bijvoorbeeld: seattle condo +parking.

  • JSON-weergave ondersteunt geparameteriseerde query's. Filters, orderby, select, count, searchFields en alle andere parameters moeten worden ingesteld in de JSON-weergave.

    Schakel over naar de JSON-weergave voor geparameteriseerde query's. In de voorbeelden in dit artikel wordt ervan uitgegaan dat de JSON-weergave overal wordt weergegeven. U kunt JSON-voorbeelden uit dit artikel in het tekstgebied plakken.

    Screenshot of the JSON view selector.

Een niet-opgegeven query uitvoeren

In Search Explorer worden POST-aanvragen intern geformuleerd met behulp van de SEARCH POST REST API, waarbij antwoorden worden geretourneerd als uitgebreide JSON-documenten.

Voer om de inhoud eerst in z'n algemeen te bekijken een lege zoekopdracht uit door op Zoeken te klikken zonder dat u zoektermen opgeeft. Een lege zoekopdracht is handig als een eerste query omdat hiermee hele documenten worden geretourneerd, zodat u de documentsamenstelling kunt bekijken. Bij een lege zoekopdracht is er geen zoekscore en worden documenten in willekeurige volgorde ("@search.score": 1 voor alle documenten) geretourneerd. Standaard worden 50 documenten geretourneerd in een zoekopdracht.

De syntaxis voor een lege zoekopdracht is * of "search": "*".

{
   "search": "*"
}

Results

Unqualified or empty query example

Vrij zoeken in tekst

Vrije query's, met of zonder operators, zijn handig voor het simuleren van door de gebruiker gedefinieerde query's die vanuit een aangepaste app naar Azure AI Search worden verzonden. Alleen de velden die in de indexdefinitie als 'doorzoekbaar' worden toegeschreven, worden gescand op overeenkomsten.

U hebt de JSON-weergave niet nodig voor een gratis tekstquery, maar we bieden deze in JSON voor consistentie met andere voorbeelden in dit artikel.

Wanneer u zoekcriteria opgeeft, zoals zoektermen of expressies, is er sprake van zoekrangschikking. Hieronder ziet u een voorbeeld van vrij zoeken in tekst. De '@search.score' is een relevantiescore die is berekend voor de overeenkomst met behulp van het standaardscore-algoritme.

{
    "search": "Seattle townhouse `Lake Washington` miele OR thermador appliance"
}

Results

U kunt Ctrl-F gebruiken om in de resultaten te zoeken naar specifieke termen.

Screenshot of a free text query example.

Aantal overeenkomende documenten

Voeg "count": true toe om het aantal overeenkomsten op te halen dat in een index is gevonden. Bij een lege zoekopdracht is count het totale aantal documenten in de index. Bij een gekwalificeerde zoekopdracht staat het voor het aantal documenten dat overeenkomt met de query-invoer. Zoals u weet, retourneert de service standaard de top 50 overeenkomsten. Het aantal kan dus duiden op meer overeenkomsten in de index dan wat in de resultaten wordt geretourneerd.

{
    "search": "Seattle townhouse `Lake Washington` miele OR thermador appliance",
    "count": true
}

Results

Screenshot of a count example.

De velden in de zoekresultaten beperken

Voeg 'select' toe om resultaten te beperken tot de expliciet benoemde velden voor meer leesbare uitvoer in Search Explorer. Alleen velden die zijn gemarkeerd als 'ophaalbaar' in de zoekindex, kunnen worden weergegeven in de resultaten.

{
   "search": "seattle condo",
   "count": true,
   "select": "listingId, beds, baths, description, street, city, price"
}

Results

Screenshot of restrict fields in search results example.

Volgende batch met resultaten retourneren

Azure AI Search retourneert de top 50 overeenkomsten op basis van de zoekpositie. Als u de volgende set overeenkomende documenten wilt ophalen, voegt u deze toe "top": 100 en "skip": 50 verhoogt u de resultatenset op 100 documenten (standaard is 50, maximum is 1000), waarbij de eerste 50 documenten worden overgeslagen. U kunt de documentsleutel (listingID) controleren om een document te identificeren.

Vergeet niet dat u zoekcriteria moet opgeven, zoals een queryterm of -expressie, om gerangschikte resultaten te verkrijgen. Naarmate u verder vordert in de zoekresultaten, nemen de zoekscores trouwens af.

{
   "search": "seattle condo",
   "count": true,
   "select": "listingId, beds, baths, description, street, city, price",
   "top": 100,
   "skip": 50
}

Results

Screenshot of returning next batch of search results example.

Filterexpressies (groter dan, kleiner dan, gelijk aan)

Gebruik de filter parameter om insluitings- of uitsluitingscriteria op te geven. Het veld moet worden toegeschreven aan 'filterbaar' in de index. In dit voorbeeld wordt gezocht naar slaapkamers met meer dan drie bedden:

{
    "search": "seattle condo",
    "count": true,
    "select": "listingId, beds, baths, description",
    "filter": "beds gt 3"
}

Results

Screenshot of a filter example.

Resultaten sorteren

Voeg toe orderby om resultaten te sorteren op een ander veld naast de zoekscore. Het veld moet worden toegeschreven aan 'sorteerbaar' in de index. In situaties waarin de gefilterde waarde identiek is (bijvoorbeeld dezelfde prijs), is de order willekeurig, maar u kunt meer criteria toevoegen voor dieper sorteren. Een voorbeeldexpressie waarmee u dit kunt uitproberen, is:

{
    "search": "seattle condo",
    "count": true,
    "select": "listingId, price, beds, baths, description",
    "filter": "beds gt 3",
    "orderby": "price asc"
}

Results

Screenshot of a sorting example.

Opgedane kennis

In deze quickstart hebt u Search Explorer gebruikt om een query uit te voeren op een index met behulp van de REST API.

  • Resultaten worden geretourneerd als uitgebreide JSON-documenten, zodat u de documentsamenstelling en -inhoud in z'n geheel kunt bekijken. De select parameter in een query-expressie kan beperken welke velden worden geretourneerd.

  • Zoekresultaten bestaan uit alle velden die zijn gemarkeerd als 'ophaalbaar' in de index. Selecteer het aangrenzende tabblad Velden om kenmerken te controleren.

  • Trefwoorden zoeken, vergelijkbaar met wat u in een commerciële webbrowser kunt invoeren, zijn handig voor het testen van een eindgebruikerservaring. Als u bijvoorbeeld de ingebouwde voorbeeldindex van onroerend goed gebruikt, kunt u 'Seattle apartments lake washington' invoeren en vervolgens Ctrl-F gebruiken om termen in de zoekresultaten te vinden.

  • Query- en filterexpressies worden geformuleerd in een syntaxis die wordt geïmplementeerd door Azure AI Search. De standaardinstelling is een eenvoudige syntaxis, maar u kunt desgewenst volledige Lucene gebruiken voor krachtigere query's. Filterexpressies worden geformuleerd in een OData-syntaxis.

Resources opschonen

Wanneer u in uw eigen abonnement werkt, is het een goed idee aan het einde van een project om te bepalen of u nog steeds de resources nodig hebt die u hebt gemaakt. Resources die actief blijven, kunnen u geld kosten. U kunt resources afzonderlijk verwijderen, maar u kunt ook de resourcegroep verwijderen als u de volledige resourceset wilt verwijderen.

U kunt resources vinden en beheren in de portal via de koppeling Alle resources of Resourcegroepen in het navigatiedeelvenster aan de linkerkant.

Als u een gratis service gebruikt, moet u er rekening mee houden dat u beperkt bent tot drie indexen, indexeerfuncties en gegevensbronnen. U kunt afzonderlijke items in de portal verwijderen om onder de limiet te blijven.

Volgende stappen

Als u meer wilt weten over querystructuren en syntaxis, gebruikt u een REST-client om query-expressies te maken die meer onderdelen van de API gebruiken. De SEARCH POST REST API is vooral nuttig voor leren en verkennen.

Een basisquery maken in REST