Dela via


Snabbstart: Använd Sökutforskaren för att köra frågor i Azure Portal

I den här snabbstarten får du lära dig hur du använder Search Explorer, ett inbyggt frågeverktyg i Azure-portalen för att köra frågor mot ett Azure AI Search-index. Använd den för att testa en fråga eller ett filteruttryck, eller bekräfta om innehållet finns i indexet.

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

Förutsättningar

Starta Sökutforskaren

  1. Leta reda på söktjänsten i Azure-portalen och öppna sidan Översikt .

  2. I kommandofältet väljer du Sökutforskaren:

    Skärmbild av kommandot Sökutforskaren i portalen.

    Du kan också välja fliken Sökutforskaren i ett öppet index.

    Skärmbild av fliken Sökutforskaren.

Fråga på tre sätt

Det finns tre metoder för att fråga i Sökutforskaren:

  • Frågevyn innehåller ett standardsökfält. Den accepterar en tom fråga eller fritextfråga med booleska värden, till exempel seattle condo + parking.

  • Bildvyn innehåller ett fönster där du kan bläddra eller dra och släppa PNG-, JPG- eller JPEG-filer. Om ditt index inte har en bildvektoriserare och motsvarande kunskaper är den här vyn inte tillgänglig.

  • JSON-vyn stöder parametriserade frågor. Filter, orderby, select, count, searchFields och alla andra parametrar måste anges i JSON-vyn.

    Skärmbild av de tre vyerna för frågor i Sökutforskaren.

Exempel: Bildfråga

Sökutforskaren accepterar bilder som frågeindata via bildvyn, vilket kräver att du använder ett vektoriserarpar som stöds. Mer information finns i Konfigurera en vektoriserare i ett sökindex.

Realestate-us-sample-index har inte konfigurerats för bildvektorisering. Om du vill köra avbildningsfrågor skapar du ett index enligt beskrivningen i Snabbstart: Vektorsökning i Azure-portalen. Snabbstarten förlitar sig på textbaserade exempeldata, så du måste använda dokument som innehåller bilder.

Om du vill köra en bildfråga väljer eller drar du en bild till sökområdet och väljer sedan Sök. Sökutforskaren vektoriserar bilden och skickar vektorn till sökmotorn för frågekörning. Sökmotorn returnerar dokument som är tillräckligt lika indatabilden, upp till det angivna k antalet resultat.

Skärmbild av sökresultat för bildsökning.

Exempel: JSON-frågor

Följande är exempel på JSON-frågor som du kan köra med Sökutforskaren. Om du vill följa de här exemplen växlar du till JSON-vyn. Du kan klistra in varje JSON-exempel i textområdet.

Dricks

JSON-vyn tillhandahåller intellisense för slutförande av parameternamn. Placera markören i JSON-vyn och skriv ett blankstegstecken för att se alla frågeparametrar. Du kan också skriva en bokstav, till exempel "s", för att bara se de frågeparametrar som börjar med den bokstaven. Intellisense utesluter inte ogiltiga parametrar, så använd ditt bästa omdöme.

Köra en ospecificerad fråga

I Sökutforskaren formuleras POST-begäranden internt med hjälp av REST-API:et Search POST, med svar som returneras som utförliga JSON-dokument.

För en första titt på innehåll kör du en tom sökning genom att välja 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 dokumentsammansättningen. Vid en tom sökning finns det ingen sökpoäng 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": "*",
   "count": true
}

Resultat

Skärmbild av exempel på okvalificerad eller tom fråga.

Köra en fritextfråga

Kostnadsfri formulärsökning, med eller utan operatorer, är användbart för att simulera användardefinierade frågor som skickas från en anpassad app till Azure AI Search. Endast de fält som tillskrivs som "sökbara" i indexdefinitionen genomsöks efter matchningar.

Du behöver inte JSON-vy för en fritextfråga, men vi tillhandahåller den i JSON för konsekvens med andra exempel i den här artikeln.

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

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

Resultat

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

Skärmbild av ett frågeexempel för fritext.

Räkna 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 antalet 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 bästa matchningarna som standard, så antalet kan tyda på fler matchningar i indexet än vad som returneras i resultatet.

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

Resultat

Skärmbild av ett räkneexempel.

Begränsa fält i sökresultat

Lägg till "select" för att begränsa resultatet till de explicit namngivna fälten för mer läsbara utdata i Sökutforskaren. Endast fält som har markerats som "hämtningsbara" i sökindexet kan visas i resultat.

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

Resultat

Skärmbild av begränsa fält i sökresultatexemplet.

Returnera nästa batch med resultat

Azure AI 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 och "skip": 50 ökar 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",
   "count": true,
   "select": "listingId, beds, baths, description, street, city, price",
   "top": 100,
   "skip": 50
}

Resultat

Skärmbild av ett exempel som returnerar nästa uppsättning sökresultat.

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

Använd parametern filter för att ange inkluderings- eller exkluderingsvillkor. Fältet måste tillskrivas som "filterbart" i indexet. Det här exemplet söker efter sovrum som är större än 3:

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

Resultat

Skärmbild av ett filterexempel.

Sortera resultat

Lägg orderby till för att sortera resultat efter ett annat fält förutom sökpoäng. Fältet måste tillskrivas som "sorterbart" i indexet. I situationer där det filtrerade värdet är identiskt (till exempel samma pris) är ordningen godtycklig, men du kan lägga till fler kriterier för djupare sortering. Ett exempeluttryck som du kan använda för att testa detta är:

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

Resultat

Skärmbild av ett sorteringsexempel.

Lärdomar

I den här snabbstarten använde du Sökutforskaren för att köra frågor mot 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. Välj fliken Intilliggande fält för att granska attribut.

  • Nyckelordssökning, som liknar det 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 AI 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 är det en bra idé i slutet av ett projekt att avgöra om du fortfarande behöver de resurser som du har skapat. Resurser som fortsätter att köras kostar pengar. Du kan ta bort enstaka resurser eller hela resursgruppen om du vill ta bort alla resurser.

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

Om du använder en kostnadsfri tjänst ska du komma ihåg att du är begränsad till tre index, indexerare och datakällor. Du kan ta bort enskilda objekt i Azure Portal 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 en REST-klient för att skapa frågeuttryck som använder fler delar av API:et. Rest-API:et search POST är särskilt användbart för inlärning och utforskning.