Quickstart: Search Explorer gebruiken om query's uit te voeren in de Azure-portal

In deze quickstart leert u hoe u Search Explorer gebruikt, een ingebouwd queryprogramma in de Azure-portal voor het uitvoeren van query's op een Azure AI Zoeken-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.

Voorwaarden

Search Explorer starten

  1. Ga naar uw zoekservice in de Azure portal.

  2. Selecteer Overzicht in het linkerdeelvenster.

  3. Selecteer Search Explorer op de opdrachtbalk.

    Schermopname van de opdracht Search Explorer in de portal.

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

Query's uitvoeren op drie manieren

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.

    Schermopname van de drie weergaven voor het uitvoeren van query's in Search Explorer.

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 de 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.

Schermopname van zoekresultaten voor afbeeldingen zoeken.

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.

Tip

De JSON-weergave ondersteunt intellisense voor het voltooien van de parameternaam. Plaats de cursor in de JSON-weergave en voer een spatie in om een lijst met alle queryparameters weer te geven. U kunt ook een letter invoeren, bijvoorbeeld s, om alleen de queryparameters te zien die met die letter beginnen.

Intellisense sluit geen ongeldige parameters uit, dus gebruik uw beste oordeel.

Een niet-opgegeven query uitvoeren

In Search Explorer worden POST-aanvragen intern geformuleerd door middel van Documenten - Search Post (REST API), waarbij antwoorden als verbose JSON-documenten worden geretourneerd.

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 eerste query omdat deze volledige documenten retourneert, 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 is het het aantal documenten dat overeenkomt met de query-invoer. Herinner u zich dat de service standaard de top-50 overeenkomsten retourneert, dus het aantal kan duiden op meer overeenkomsten in de index dan er in de resultaten worden geretourneerd.

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

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

Resultaten

Schermopname van een voorbeeld van het aantal.

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 Zoeken 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.

U merkt dat wanneer u zoekcriteria opgeeft, zoals querytermen of uitdrukkingen, de zoekrangschikking een rol gaat spelen. In het volgende voorbeeld ziet u een zoekopdracht in vrije tekst. De @search.score is een relevantiescore die wordt berekend voor de overeenkomst met behulp van het standaardscore-algoritme.

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

Resultaten

U kunt Ctrl-F gebruiken om te zoeken in resultaten voor specifieke interessevoorwaarden.

Schermopname van een voorbeeld van een gratis tekstquery.

Velden in zoekresultaten beperken

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

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

Resultaten

Schermopname van velden beperken in het voorbeeld van zoekresultaten.

Volgende batch met resultaten retourneren

Azure AI Zoeken retourneert de top-50 overeenkomsten op basis van de zoekpositie. De hotels-sample index heeft slechts 50 hotels, dus we gebruiken een kleiner aantal om 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.

Zoals u zich herinnert, moet u zoekcriteria opgeven, zoals een queryterm of expressie, om gerangschikte resultaten op te halen. 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

Schermopname van het retourneren van de volgende batch met zoekresultaten.

Filter-expressies (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

Schermopname van een filtervoorbeeld.

Resultaten sorteren

Voeg toe orderby om resultaten te sorteren op een ander veld naast de zoekscore. Het veld moet als sorteerbaar worden aangegeven 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. 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

Schermopname van een sorteervoorbeeld.

Conclusies

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 kunnen worden opgehaald 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 Zoeken. De standaardwaarde is een eenvoudige syntaxis, maar u kunt eventueel 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 om een project te voltooien door de resources te verwijderen die u niet meer nodig hebt. Resources die nog actief zijn, kunnen u geld kosten.

Selecteer in de Azure portal Alle resources of Resourcegroepen in het linkerdeelvenster om resources te zoeken en te beheren. U kunt resources afzonderlijk verwijderen of de resourcegroep verwijderen om alle resources tegelijk te verwijderen.

Als u een gratis zoekservice 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 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.

Snelstart: Zoeken in volledige tekst

  • Last updated on