Krok 1 – přehled přidání vyhledávání na web pomocí .NET
Tento kurz vytvoří web pro vyhledávání v katalogu knih a pak nasadí web do statické webové aplikace Azure.
Co ukázka dělá?
Tento ukázkový web poskytuje přístup k katalogu 10 000 knih. Uživatel může katalog prohledávat zadáním textu na panelu hledání. Když uživatel zadá text, web k dokončení textu použije funkci návrhu vyhledávacího indexu. Po dokončení dotazu se zobrazí seznam knih s částí podrobností. Uživatel může vybrat knihu, aby se zobrazily všechny podrobnosti uložené v indexu vyhledávání knihy.
Vyhledávací prostředí zahrnuje:
- Vyhledávání – poskytuje funkci vyhledávání pro aplikaci.
- Navrhnout – poskytuje návrhy, když uživatel píše na panelu hledání.
- Fasety a filtry – poskytuje fasetovou navigační strukturu, která filtruje podle autora nebo jazyka.
- Stránkované výsledky – poskytuje ovládací prvky stránkování pro posouvání výsledků.
- Vyhledávání dokumentů – vyhledá dokument podle ID a načte veškerý jeho obsah stránky podrobností.
Jak je ukázka uspořádaná?
Ukázkový kód obsahuje následující složky:
Aplikace | Účel | GitHubu Repository Umístění |
---|---|---|
Klient | Aplikace React (prezentační vrstva) k zobrazení knih s hledáním Volá aplikaci Funkcí Azure. | /search-website-functions-v4/client |
Server | Aplikace funkcí Azure .NET (obchodní vrstva) – volá rozhraní API služby Azure AI Search pomocí sady .NET SDK. | /search-website-functions-v4/api |
Hromadné vložení (Bulk insert) | Soubor .NET pro vytvoření indexu a přidání dokumentů do něj. | /search-website-functions-v4/bulk-insert |
Nastavení vývojového prostředí
Nainstalujte následující software pro místní vývojové prostředí.
- .NET 6 nebo novější
- Git
- Visual Studio Code a následující rozšíření
- Webová aplikace Azure Static
- Pro operace příkazového řádku použijte integrovaný terminál.
- Volitelné:
- Tento kurz nespouští rozhraní API služby Azure Functions místně, ale pokud ho chcete spustit místně, musíte nainstalovat nástroje azure-functions-core-tools.
Vytvoření forku a naklonování ukázky hledání pomocí Gitu
Vytvoření forku ukázkového úložiště je důležité, aby bylo možné nasadit statickou webovou aplikaci. Webové aplikace určují akce sestavení a obsah nasazení na základě vlastního umístění forku GitHubu. Spouštění kódu ve statické webové aplikaci je vzdálené a služba Azure Static Web Apps čte z kódu ve vaší forkované ukázce.
Na GitHubu forkujte ukázkové úložiště.
Dokončete proces forku ve webovém prohlížeči pomocí účtu GitHub. Tento kurz používá váš fork jako součást nasazení do azure Static Web Appu.
V terminálu Bash si stáhněte rozvětvovanou ukázkovou aplikaci do místního počítače.
Nahraďte
YOUR-GITHUB-ALIAS
aliasem GitHubu.git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-dotnet-samples
Ve stejném terminálu Bash přejděte do vašeho forku úložiště pro tento příklad vyhledávání na webu:
cd azure-search-dotnet-samples
K otevření rozvětvovaného úložiště použijte příkaz
code .
editoru Visual Studio Code. Zbývající úlohy se provádějí v editoru Visual Studio Code, pokud nejsou zadané.code .
Vytvoření skupiny prostředků pro prostředky Azure
V editoru Visual Studio Code otevřete panel aktivit a vyberte ikonu Azure.
Pokud ještě nejste přihlášení, přihlaste se k Azure.
V části Zdroje vyberte Přidat (+) a pak vyberte Vytvořit skupinu prostředků.
Zadejte název skupiny prostředků, například
cognitive-search-demo-rg
.Zadejte oblast:
- V Node.js vyberte
West US 2
. Toto je doporučená oblast pro programovací model funkce Azure (PM) v4 Preview. - Pro C# a Python doporučujeme následující oblasti podporované službou Azure Static Web Apps od tohoto psaní:
West US 2
,East US 2
,West Europe
,Central US
East Asia
- V Node.js vyberte
Tuto skupinu prostředků použijte pro všechny prostředky vytvořené během tohoto kurzu. Skupina prostředků poskytuje logickou jednotku pro správu prostředků, včetně jejich odstranění po dokončení.