Snabbstart: Skapa ett sökindex i Azure Portal

2025-05-20

I den här snabbstarten skapar du ditt första Azure AI Search-index med hjälp av guiden Importera data och ett inbyggt exempel på fiktiva hotelldata som hanteras av Microsoft. Guiden kräver ingen kod för att skapa ett index, vilket hjälper dig att skriva intressanta frågor inom några minuter.

Guiden skapar flera objekt i söktjänsten, inklusive ett sökbart index, en indexerare och en datakällaanslutning för automatisk datahämtning. I slutet av den här snabbstarten granskar vi varje objekt.

Kommentar

Guiden Importera data innehåller alternativ för OCR, textöversättning och andra AI-berikanden som inte beskrivs i den här snabbstarten. En liknande genomgång som fokuserar på tillämpad AI finns i Snabbstart: Skapa en kompetensuppsättning i Azure Portal.

Förutsättningar

Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
En Azure AI-tjänsten Search. Skapa en tjänst eller hitta en befintlig tjänst i din aktuella prenumeration. Du kan använda en kostnadsfri tjänst för den här snabbstarten.
Bekanta dig med guiden. Se Importera dataassistenter i Azure-portalen.

Sök efter nätverksåtkomst

För den här snabbstarten, som använder inbyggda exempeldata, kontrollerar du att söktjänsten inte har nätverksåtkomstkontroller. Kontroller i Azure-portalen använder en offentlig slutpunkt för att hämta data och metadata från den Microsoft-hostade datakällan. Mer information finns i Säkra anslutningar i importguiderna.

Kontrollera utrymmet

Många kunder börjar med en kostnadsfri söktjänst, som är begränsad till tre index, tre indexerare och tre datakällor. Den här snabbstarten skapar en av var och en, så se till att du har plats för extra objekt innan du börjar.

På fliken Översikt väljer du Användning för att se hur många index, indexerare och datakällor du har för närvarande.

Starta guiden

Logga in på Azure-portalen.
Gå till söktjänsten.
På fliken Översikt väljer du Importera data för att starta guiden.

Skapa och läsa in ett sökindex

I det här avsnittet skapar och läser du in ett index i fyra steg:

Ansluta till en datakälla
Hoppa över konfiguration för kognitiva färdigheter
Konfigurera indexet
Konfigurera och köra indexeraren

Anslut till en datakälla

Guiden skapar en datakällanslutning till exempeldata som Microsoft hostar i Azure Cosmos DB. Exempeldata nås via en offentlig slutpunkt, så du behöver inget Azure Cosmos DB-konto eller källfiler för det här steget.

Så här ansluter du till exempeldata:

I Anslut till dina data expanderar du listrutan Datakälla och väljer Exempel.
Välj hotellexempel i listan över inbyggda exempel.
Välj Nästa: Lägg till kognitiva färdigheter (valfritt) för att fortsätta.

Hoppa över konfiguration för kognitiva färdigheter

Guiden stöder skapande av färdighetsuppsättningar och AI-berikning vid indexering, men kognitiva färdigheter ligger utanför den här snabbstartsguidens omfång.

Hoppa över detta steg i guiden:

På Lägg till kognitiva färdigheter ignorerar du konfigurationsalternativen för AI-berikning.
Välj Nästa: Anpassa målindex för att fortsätta.

Dricks

Information om hur du kommer igång med AI-berikande finns i Snabbstart: Skapa en kompetensuppsättning i Azure-portalen.

Konfigurera indexet

Guiden härleder ett schema för hotell-exempelindexet. Så här konfigurerar du indexet:

Acceptera de systemgenererade värdena för indexnamnet (hotels-sample-index) och Key (HotelId).
Acceptera de systemgenererade värdena för alla fältattribut.
Välj Nästa: Skapa en indexerare för att fortsätta.

Sökindexet kräver minst ett namn och en samling fält. Guiden söker efter unika strängfält och markerar ett som dokumentnyckel, som unikt identifierar varje dokument i indexet.

Varje fält har ett namn, en datatyp och attribut som styr hur fältet används i indexet. Använd kryssrutorna för att aktivera eller inaktivera följande attribut:

Egenskap	Beskrivning	Tillämpliga datatyper
Hämtningsbart	Fält som returneras i svar på en fråga.	Strängar och heltal
Filtrerbar	Fält som accepterar ett filteruttryck.	Heltal
Sorterbar	Fält som accepterar ett orderby-uttryck.	Heltal
Fasettbar	Fält som används i en fasetterad navigeringsstruktur.	Heltal
Sökbar	Fält som används i fulltextsökning. Strängar är sökbara, men numeriska och booleska fält markeras ofta som inte sökbara.	Strängar

Attribut påverkar lagringen på olika sätt. Till exempel förbrukar filterbara fält extra lagringsutrymme, medan hämtningsbara fält inte gör det. Mer information finns i Exempel som visar lagringskonsekvenserna av attribut och förslagsgivare.

Om du vill komplettera automatiskt eller föreslå frågor anger du språkanalysverktyg eller förslagsgivare.

Konfigurera och köra indexeraren

Slutligen konfigurerar och kör du indexeraren, som definierar en körbar process. Datakällan och indexet skapas också i det här steget.

Så här konfigurerar och kör du indexeraren:

Acceptera det systemgenererade värdet för Indexer-namnet (hotels-sample-indexer).
I den här snabbstarten använder du standardalternativet för att köra indexeraren omedelbart och bara en gång. Exempeldata är statiska, så du kan inte aktivera ändringsspårning.
Välj Skicka för att skapa och köra indexeraren samtidigt.

Övervaka indexerarens förlopp

Du kan övervaka skapandet av indexeraren och indexet i Azure-portalen. Fliken Översikt innehåller länkar till de resurser som skapats i söktjänsten.

Så här övervakar du indexerarens förlopp:

Gå till söktjänsten i Azure Portal.
Välj Indexerare i den vänstra rutan.

Det kan ta några minuter innan resultatet uppdateras. Du bör se den nyligen skapade indexeraren med statusen Pågår eller Lyckades. Listan visar också antalet dokument som indexerats.

Kontrollera sökresultat för sökindex

Gå till söktjänsten i Azure Portal.
Välj Index i den vänstra rutan.
Välj hotels-sample-index. Om indexet inte har några dokument eller lagringsutrymme väntar du på att Azure-portalen ska uppdateras.
Välj fliken Fält för att visa indexschemat.
Kontrollera vilka fält som kan filtreras eller sorteras så att du vet vilka frågor som ska skrivas.

Lägga till eller ändra fält

På fliken Fält kan du skapa ett fält genom att välja Lägg till fält och ange ett namn, datatyp och attribut som stöds.

Det är svårare att ändra befintliga fält. Befintliga fält har en fysisk representation i sökindexet, så de kan inte ändras, inte ens i kod. Om du vill ändra ett befintligt fält i grunden måste du skapa ett nytt fält för att ersätta originalet. Du kan lägga till andra konstruktioner, till exempel bedömningsprofiler och CORS-alternativ, i ett index när som helst.

Granska alternativen för indexdefinition för att förstå vad du kan och inte kan redigera under indexdesignen. Om ett alternativ visas nedtonat kan du inte ändra eller ta bort det.

Fråga med Sökutforskaren

Nu har du ett sökindex som kan efterfrågas med hjälp av Sökutforskaren, som skickar REST-anrop som överensstämmer med REST-API:et search POST. Det här verktyget stöder enkel frågesyntax och fullständig Lucene-frågesyntax.

För att söka i ditt sökindex:

På fliken Sökutforskaren anger du text att söka efter.
Om du vill hoppa till områden som inte kan visas i utdata använder du minikartan.
Om du vill ange syntax växlar du till JSON-vyn.

Exempelfrågor för hotell-exempelindex

I följande exempel förutsätts JSON-vyn och REST API-versionen 2024-05-01-preview.

Dricks

JSON-vyn stöder intellisense för slutförande av parameternamn. Placera markören i JSON-vyn och skriv ett blankstegstecken för att se en lista över 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.

Filtrera exempel

Parkering, taggar, renoveringsdatum, klassificering och plats kan filtreras.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "Rating gt 4"
}

Booleska filter förutsätter "sant" som standard.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "ParkingIncluded"
}

Geospatial sökning är filterbaserad. Funktionen geo.distance filtrerar alla resultat för positionsdata baserat på angivna Location och geography'POINT koordinater. Frågan söker hotell inom fem kilometer från latitud- och longitudkoordinaterna -122.12 47.67, som är "Redmond, Washington, USA". Frågan visar det totala antalet matchningar &$count=true med hotellnamnen och adressplatserna.

{
    "search": "*",
    "select": "HotelName, Address/City, Address/StateProvince",
    "count": true,
    "top": 10,
    "filter": "geo.distance(Location, geography'POINT(-122.12 47.67)') le 5"
}

Fullständiga Lucene-syntaxexempel

Standardsyntaxen är enkel syntax, men om du vill ha fuzzy-sökning, termförstärkningar eller reguljära uttryck anger du den fullständiga syntaxen.

{
    "queryType": "full",
    "search": "seatle~",
    "select": "HotelId, HotelName,Address/City, Address/StateProvince",
    "count": true
}

Felstavade frågetermer, till exempel seatle i stället Seattleför , returnerar inte matchningar i en typisk sökning. Parametern queryType=full anropar den fullständiga Lucene-frågeparsern, som stöder tilde-operanden (~). När du använder dessa parametrar utför frågan en fuzzy-sökning efter det angivna nyckelordet och matchar på termer som är liknande men inte en exakt matchning.

Det tar en minut att prova de här exempelfrågorna i ditt index. Mer information om frågor finns i Fråga i Azure AI Search.

Rensa resurser

När du arbetar i din egen prenumeration är det en bra idé i slutet av ett projekt att identifiera 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.

I Azure-portalen kan du hitta och hantera resurser för tjänsten under Alla resurser eller Resursgrupper i den vänstra rutan.