Snabbstart: Använda Sökutforskaren för att köra frågor i portalen

I den här snabbstarten får du lära dig hur du använder Sökutforskaren, ett inbyggt frågeverktyg i Azure Portal som används för att köra frågor mot ett sökindex i Azure Cognitive Search. Det här verktyget gör det enkelt att lära sig frågesyntax, testa en fråga eller ett filteruttryck eller bekräfta datauppdateringen genom att kontrollera om det finns nytt innehåll i indexet.

Den här snabbstarten använder ett befintligt index för att demonstrera Sökutforskaren.

Krav

Innan du börjar måste du ha följande förutsättningar på plats:

  • Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.

  • En Azure Cognitive Search tjänst. Skapa en tjänst eller hitta en befintlig tjänst under din aktuella prenumeration. Du kan använda en kostnadsfri tjänst för den här snabbstarten.

  • Realestate-us-sample-index används för den här snabbstarten. Om du vill skapa indexet använder du guiden Importera data, väljer exempeldata och går igenom guiden med alla standardvärden.

    Skärmbild av de exempeldatauppsättningar som är tillgängliga i guiden Importera data.

Starta Sökutforskaren

  1. I Azure Portal öppnar du sököversiktssidan från instrumentpanelen eller letar upp din tjänst.

  2. Öppna Sökutforskaren från kommandofältet:

    Kommandot Sökutforskaren i portalen

    Eller använd den inbäddade sökutforskaren i ett öppet index:

    Fliken Sökutforskaren

Ospecificerad fråga

I Sökutforskaren formuleras begäranden med hjälp av REST API för sökning, med svar som returneras som utförliga JSON-dokument.

Om du vill ta en första titt på innehållet kör du en tom sökning genom att klicka på Sök utan angivna villkor. En tom sökning är användbar som en första fråga eftersom den returnerar hela dokument så att du kan granska dokumentets sammansättning. Vid en tom sökning finns det ingen sökrankning och dokument returneras i godtycklig ordning ("@search.score": 1 för alla dokument). Som standard returneras 50 dokument i en sökbegäran.

Motsvarande syntax för en tom sökning är * eller search=*.

search=*

Resultat

Exempel på okvalificerad eller tom fråga

Kostnadsfria frågor, med eller utan operatorer, är användbara för att simulera användardefinierade frågor som skickas från en anpassad app till Azure Cognitive Search. Endast de fält som anges som Sökbara i indexdefinitionen genomsöks efter matchningar.

Observera att när du anger sökvillkor, till exempel frågetermer eller uttryck, kommer sökrankning att spela in. I följande exempel visas en fritextsökning. "@search.score" är en relevanspoäng som beräknas för matchningen med hjälp av standardbedömningsalgoritmen.

Seattle apartment "Lake Washington" miele OR thermador appliance

Resultat

Du kan använda Ctrl-F för att söka i resultat efter specifika intressevillkor.

Frågeexempel för fritext

Antal matchande dokument

Lägg till $count=true för att hämta antalet matchningar som hittas i ett index. Vid en tom sökning är count det totala antalet dokument i indexet. Vid en kvalificerad sökning är det antalet dokument som matchar frågeindata. Kom ihåg att tjänsten returnerar de 50 främsta matchningarna som standard, så antalet kan indikera fler matchningar i indexet än vad som returneras i resultatet.

$count=true

Resultat

Antal matchande dokument i index

Begränsa fält i sökresultat

Lägg till $select för att begränsa resultaten till de explicit namngivna fälten för mer läsbara utdata i Sökutforskaren. Om du vill behålla de tidigare nämnda parametrarna i frågan använder du & för att avgränsa varje parameter.

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

Resultat

Begränsa fält i sökresultat

Returnera nästa batch med resultat

Azure Cognitive Search returnerar de 50 bästa matchningarna baserat på sökrankningen. Om du vill hämta nästa uppsättning matchande dokument lägger du till $top=100,&$skip=50 för att öka resultatuppsättningen till 100 dokument (standardvärdet är 50, max är 1 000) och hoppar över de första 50 dokumenten. Du kan kontrollera dokumentnyckeln (listingID) för att identifiera ett dokument.

Kom ihåg att du måste ange sökvillkor, till exempel en frågeterm eller ett uttryck, för att få rankade resultat. Observera att sökpoängen minskar ju djupare du når sökresultaten.

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

Resultat

Returnera nästa batch med sökresultat

Filteruttryck (större än, mindre än, lika med)

Använd parametern $filter när du vill ange exakta villkor i stället för fritextsökning. Fältet måste tilldelas som Filterable i indexet. Det här exemplet söker efter sovrum som är större än 3:

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

Resultat

Filtrera efter villkor

Sortera resultat

Lägg till $orderby för att sortera resultat efter ett annat fält förutom sökpoäng. Fältet måste tilldelas som Sorterbart i indexet. Ett exempeluttryck som du kan använda för att testa detta är:

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

Resultat

Ändra sorteringsordning

Både $filter och $orderby uttryck är OData-konstruktioner. Mer information finns i OData-filtersyntax.

Lärdomar

I den här snabbstarten använde du Sökutforskaren för att fråga ett index med hjälp av REST-API:et.

  • Resultaten returneras som utförliga JSON-dokument så att du kan visa dokumentkonstruktion och innehåll i sin helhet. Parametern $select i ett frågeuttryck kan begränsa vilka fält som returneras.

  • Sökresultaten består av alla fält som markerats som Hämtningsbara i indexet. Om du vill visa fältattribut i portalen väljer du realestate-us-sample i listan Index på sököversiktssidan och öppnar sedan fliken Fält .

  • Nyckelordssökning, som liknar vad du kan ange i en kommersiell webbläsare, är användbara för att testa en slutanvändarupplevelse. Om du till exempel antar det inbyggda exempelindexet för fastigheter kan du ange "Seattle apartments lake washington" och sedan kan du använda Ctrl-F för att hitta termer i sökresultaten.

  • Fråge- och filteruttryck formuleras i en syntax som implementeras av Azure Cognitive Search. Standardinställningen är en enkel syntax, men du kan också använda fullständig Lucene för mer kraftfulla frågor. Filteruttryck artikuleras i en OData-syntax.

Rensa resurser

När du arbetar i din egen prenumeration kan det dock vara klokt att i slutet av ett projekt kontrollera om du fortfarande behöver de resurser som du skapade. Resurser som fortsätter att köras kostar pengar. Du kan ta bort resurser individuellt eller ta bort resursgruppen om du vill ta bort hela uppsättningen resurser.

Du kan hitta och hantera resurser i portalen med hjälp av länken Alla resurser eller Resursgrupper i det vänstra navigeringsfönstret.

Kom ihåg att du är begränsad till tre index, indexerare och datakällor om du använder en kostnadsfri tjänst. Du kan ta bort enskilda objekt i portalen för att hålla dig under gränsen.

Nästa steg

Om du vill veta mer om frågestrukturer och syntax använder du Postman eller ett motsvarande verktyg för att skapa frågeuttryck som använder fler delar av API:et. REST API för sökning är särskilt användbart för inlärning och utforskning.