Anteckning
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
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 Seattle
fö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.
Kommentar
Om du använder en kostnadsfri söktjänst ska du komma ihåg att gränsen är tre index, tre indexerare och tre datakällor. Du kan ta bort enskilda objekt i Azure-portalen för att hålla dig under gränsen.
Nästa steg
Prova en Azure Portal-guide för att generera en färdig webbapp som körs i en webbläsare. Använd den här guiden i det lilla index som du skapade i den här snabbstarten eller använd en av de inbyggda exempeldatauppsättningarna för en bättre sökupplevelse.