1. lépés – A keresés .NET-tel rendelkező webhelyre történő hozzáadásának áttekintése
Ez az oktatóanyag létrehoz egy webhelyet a könyvek katalógusában való kereséshez, majd üzembe helyezi a webhelyet egy Azure statikus webalkalmazásban.
Mit csinál a minta?
Ez a mintaweboldal 10 000 könyvből álló katalógushoz biztosít hozzáférést. A felhasználó kereshet a katalógusban, ha szöveget ír be a keresősávba. Miközben a felhasználó szöveget ír be, a webhely a keresési index javaslati funkcióját használja a szöveg befejezéséhez. Miután a lekérdezés befejeződött, a könyvek listája megjelenik a részletek egy részével. A felhasználó kiválaszthat egy könyvet, hogy megtekintse a könyv keresési indexében tárolt összes részletet.
A keresési felület a következőket tartalmazza:
- Keresés – keresési funkciókat biztosít az alkalmazáshoz.
- Javaslat – javaslatokat ad, miközben a felhasználó beírja a keresősávot.
- Aspektusok és szűrők – olyan strukturált navigációs struktúrát biztosít, amely szerző vagy nyelv szerint szűr.
- Lapszámozott eredmények – lapozási vezérlőket biztosít az eredmények görgetéshez.
- Dokumentumkeresés – megkeres egy dokumentumot azonosító alapján, hogy lekérje a részletek lap összes tartalmát.
Hogyan van rendszerezve a minta?
A mintakód a következő mappákat tartalmazza:
App | Cél | GitHub Adattár Hely |
---|---|---|
Ügyfél | A React alkalmazás (bemutató réteg) a könyvek kereséssel való megjelenítéséhez. Meghívja az Azure-függvényalkalmazást. | /search-website-functions-v4/client |
Kiszolgáló | Azure .NET-függvényalkalmazás (üzleti réteg) – meghívja az Azure AI Search API-t a .NET SDK használatával | /search-website-functions-v4/api |
Tömeges beszúrás | .NET-fájl az index létrehozásához és dokumentumok hozzáadásához. | /search-website-functions-v4/bulk-insert |
A fejlesztési környezet beállítása
Telepítse a következő szoftvert a helyi fejlesztési környezethez.
- .NET 6 vagy újabb
- Git
- Visual Studio Code és a következő bővítmények
- Azure Static Web App
- A parancssori műveletekhez használja az integrált terminált.
- Választható:
- Ez az oktatóanyag nem helyileg futtatja az Azure Function API-t, de ha helyileg szeretné futtatni, telepítenie kell az Azure-Functions-core-tools eszközt.
A keresési minta elágazása és klónozása a gittel
A mintaadattár elágaztatása kritikus fontosságú a statikus webalkalmazás üzembe helyezéséhez. A webalkalmazások a saját GitHub-elágazásaik alapján határozzák meg a buildelési műveleteket és az üzembe helyezési tartalmakat. A statikus webalkalmazásban a kódvégrehajtás távoli, az Azure Static Web Apps pedig az elágazott mintában lévő kódból olvas fel.
A GitHubon fordozza el a mintaadattárat.
Fejezze be az elágazással kapcsolatos folyamatot a webböngészőben a GitHub-fiókjával. Ez az oktatóanyag az elágazást használja az Azure Static Web App üzembe helyezésének részeként.
Egy Bash-terminálon töltse le az elágazott mintaalkalmazást a helyi számítógépre.
Cserélje le
YOUR-GITHUB-ALIAS
a GitHub-aliasát.git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-dotnet-samples
Ugyanabban a Bash-terminálban lépjen az elágazott adattárba a webhely keresési példájához:
cd azure-search-dotnet-samples
A Visual Studio Code paranccsal
code .
nyissa meg az elágazott adattárat. A fennmaradó feladatok a Visual Studio Code-ból lesznek végrehajtva, kivéve, ha meg vannak adva.code .
Erőforráscsoport létrehozása az Azure-erőforrásokhoz
A Visual Studio Code-ban nyissa meg a Tevékenységsávot, és válassza az Azure ikont.
Jelentkezzen be az Azure-ba, ha még nincs bejelentkezve.
Az Erőforrások szakaszban válassza a Hozzáadás (+), majd az Erőforráscsoport létrehozása lehetőséget.
Adjon meg egy erőforráscsoportnevet, például
cognitive-search-demo-rg
.Adjon meg egy régiót:
- A Node.js válassza a
West US 2
lehetőséget. Ez a javasolt régió az Azure Functions programozási modell (PM) v4 előzetes verziójához. - A C# és a Python esetében a következő régiókat javasoljuk, amelyeket az Azure Static Web Apps támogat az írás során:
West US 2
,East US 2
, ,West Europe
,Central US
East Asia
- A Node.js válassza a
Használja ezt az erőforráscsoportot az oktatóanyag során létrehozott összes erőforráshoz. Az erőforráscsoportok egy logikai egységet adnak az erőforrások kezeléséhez, beleértve az erőforrások törlését is, ha végzett.