Delen via

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.

Tip

Search Explorer biedt nu ondersteuning voor afbeeldingen zoeken. Quickstart: Afbeeldingen zoeken in Azure Portal bevat de stappen.

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.

    Schermopname van de voorbeeldgegevenssets die beschikbaar zijn in de wizard Gegevens importeren.

Start Search Explorer

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

  2. Open Search Explorer vanuit de opdrachtbalk:

    Schermopname van de opdracht Search Explorer in de portal.

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

    Schermopname van het tabblad Search Explorer.

Query's uitvoeren op twee manieren

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

  • De queryweergave biedt een standaardzoekbalk. Het 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.

    Tip

    De JSON-weergave biedt intellisense voor voltooiing van de parameternaam. Plaats de cursor in de JSON-weergave en typ een spatieteken om een lijst met alle queryparameters weer te geven, of typ een enkele letter, zoals 's' om alleen de queryparameters weer te geven die beginnen met 's'. Intellisense sluit geen ongeldige parameters uit, dus gebruik uw beste oordeel.

    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.

    Schermopname van de JSON-weergavekiezer.

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

Voorbeeld van niet-gekwalificeerde of lege query

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.

Schermopname van een voorbeeld van een gratis tekstquery.

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

Schermopname van een voorbeeld van het aantal.

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

Schermopname van velden beperken in het voorbeeld van zoekresultaten.

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

Schermopname van het retourneren van de volgende batch met zoekresultaten.

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

Schermopname van een filtervoorbeeld.

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

Schermopname van een sorteervoorbeeld.

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