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

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

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

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. Voor deze quickstart kunt u een gratis service gebruiken.

• In deze quickstart wordt gebruikgemaakt van de voorbeeldindex hotels. Volg de instructies in deze quickstart om de index te maken.

Start Search Explorer

1. Meld u aan bij Azure Portal en selecteer uw zoekservice.

2. Selecteer Overzicht in het linkerdeelvenster.

3. Selecteer Search Explorer op de opdrachtbalk.

   

   U kunt ook het tabblad Search Explorer op de indexpagina selecteren.

Drie manieren van vragen

Er zijn drie benaderingen voor het uitvoeren van query's in Search Explorer:

• De queryweergave biedt een standaardzoekbalk. Het accepteert een lege query of vrije-tekstquery met Booleaanse waarden, zoals ocean view + parking.

• De afbeeldingsweergave biedt een venster voor het bladeren of slepen en neerzetten van PNG-, JPG- of JPEG-bestanden. Tenzij uw index een afbeeldingsvectorizer en een equivalente vaardigheid heeft, is deze weergave niet beschikbaar.

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

  

Voorbeeld: Afbeeldingsquery

Search Explorer accepteert afbeeldingen als queryinvoer via de afbeeldingsweergave. Hiervoor moet u een ondersteund vectorizer-vaardigheidspaar gebruiken. Zie Een vectorizer configureren in een zoekindex voor meer informatie.

De voorbeeldindex hotels is niet geconfigureerd voor afbeeldingsvectorisatie. Als u afbeeldingsquery's wilt uitvoeren, maakt u een index zoals beschreven in quickstart: Vector search in Azure Portal. De quickstart is afhankelijk van voorbeeldgegevens op basis van tekst, dus u moet documenten gebruiken die afbeeldingen bevatten.

Als u een afbeeldingsquery wilt uitvoeren, selecteert of sleept u een afbeelding naar het zoekgebied en selecteert u Vervolgens Zoeken. Search Explorer vectoriseert de afbeelding en verzendt de vector naar de zoekmachine voor het uitvoeren van query's. De zoekmachine retourneert documenten die voldoende vergelijkbaar zijn met de invoerafbeelding, tot het opgegeven k aantal resultaten.

Voorbeelden: JSON-query's

Hier volgen enkele voorbeelden van JSON-query's die u kunt uitvoeren met Search Explorer. Als u deze voorbeelden wilt volgen, schakelt u over naar de JSON-weergave. U kunt elk JSON-voorbeeld in het tekstgebied plakken.

Een niet-opgegeven query uitvoeren

In Search Explorer worden POST-aanvragen binnen geformuleerd met behulp van Documenten - Search Post (REST API), met antwoorden die worden geretourneerd als uitgebreide JSON-documenten.

Voor een eerste blik op inhoud voert u een lege zoekopdracht uit door Zoeken te selecteren zonder opgegeven termen. 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 geretourneerd ("@search.score": 1 voor alle documenten). Standaard worden er 50 documenten geretourneerd per zoekaanvraag.

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

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

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

resultaten

Een vrije-tekstquery uitvoeren

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

U hebt de JSON-weergave niet nodig voor een vrije-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 relevantie-score die wordt berekend voor de match met behulp van het standaardscore-algoritme.

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

resultaten

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

De velden in de zoekresultaten beperken

Voeg toe "select" om resultaten te beperken tot de expliciet benoemde velden voor meer leesbare uitvoer in Search Explorer. Alleen velden die als op te halen zijn aangeduid in de index, kunnen in resultaten worden weergegeven.

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

resultaten

Volgende batch met resultaten retourneren

Azure AI Search levert de top-50 resultaten op basis van de zoekrangorde. De hotels-voorbeeldindex bevat slechts 50 hotels, dus we gebruiken een kleiner aantal om de paginering te illustreren. Als u de volgende set overeenkomende documenten wilt ophalen, voegt u deze toe "top": 20 en "skip": 10 verhoogt u de resultatenset op 20 documenten (standaard is 50, maximum is 1000), waarbij de eerste 10 documenten worden overgeslagen. U kunt de documentsleutel (HotelId) controleren om een document te identificeren.

Vergeet niet dat u zoekcriteria moet opgeven, zoals een queryterm of -expressie, om gerangschikte resultaten te verkrijgen. Zoekscores nemen af hoe dieper u in zoekresultaten komt.

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

resultaten

Filterexpressies (groter dan, kleiner dan, gelijk aan)

Gebruik de filter parameter om insluitings- of uitsluitingscriteria op te geven. Het veld moet worden toegeschreven als filterbaar in de index. In dit voorbeeld wordt gezocht naar classificaties die groter zijn dan vier:

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

resultaten

Resultaten sorteren

Voeg toe orderby om resultaten te sorteren op een ander veld naast de zoekscore. Het veld moet als sorteerbaar in de index worden aangemerkt. In situaties waarin de gefilterde waarde identiek is (bijvoorbeeld dezelfde prijs), is de order willekeurig, maar u kunt meer criteria toevoegen voor dieper sorteren. Hier volgt een voorbeeldexpressie die u kunt gebruiken om dit te testen:

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

resultaten

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 constructie en inhoud van elk document volledig kunt bekijken. De select parameter in een queryexpressie beperkt welke velden worden geretourneerd.

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

• Trefwoorden zoeken, vergelijkbaar met wat u in een commerciële webbrowser kunt invoeren, is handig voor het testen van een eindgebruikerservaring. Bijvoorbeeld, ervan uitgaande dat u de voorbeeldindex hotels kunt invoeren "activities 'outdoor pool' restaurant OR continental breakfast"en vervolgens kunt u 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.

In Azure Portal kunt u resources vinden en beheren door alle resources of resourcegroepen te selecteren in het linkerdeelvenster.

Houd er rekening mee dat een gratis zoekservice beperkt is tot drie indexen, drie indexeerfuncties en drie gegevensbronnen. Als u onder de limiet wilt blijven, kunt u deze items afzonderlijk verwijderen in Azure Portal.

Volgende stap

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