Шаг 1. Обзор добавления поиска в статическое веб-приложение с помощью .NET
В этом руководстве создается веб-сайт для поиска по каталогу книг, а затем развертывается веб-сайт в статическом веб-приложении Azure.
Как работает пример?
Этот пример веб-сайта предоставляет доступ к каталогу, содержащему 10 000 книг. Вы можете выполнить поиск по каталогу, введя текст в строке поиска. При вводе текста веб-сайт использует функцию предложения индекса поиска для автозавершения текста. После завершения запроса отображается список книг с частью сведений. Вы можете выбрать книгу, чтобы просмотреть все сведения, хранящиеся в индексе поиска, книги.
Возможности поиска включают в себя:
- Поиск — предоставляет функции поиска для приложения.
- Предложение — предоставляет предложения по мере ввода пользователя в строке поиска.
- Аспекты и фильтры — предоставляет фасетную структуру навигации , которая фильтрует по автору или языку.
- Результаты с разбивкой на страницы — предоставляют элементы управления разбиением на страницы для прокрутки результатов.
- Поиск документа — ищет документ по идентификатору, чтобы получить все его содержимое для страницы сведений.
Какова структура примера?
Пример кода включает следующие компоненты:
| Приложение | Характер использования | GitHub Репозиторий Расположение |
|---|---|---|
| клиент | Приложение React (уровень представления) для отображения книг с помощью поиска. Оно вызывает приложение-функцию Azure. | /azure-search-static-web-app/client |
| api | Приложение-функция Azure .NET (бизнес-уровень) — вызывает API поиска ИИ Azure с помощью пакета SDK для .NET | /azure-search-static-web-app/api |
| массовая вставка | Проект .NET для создания индекса и добавления в него документов. | /azure-search-static-web-app/bulk-insert |
Настройка среды разработки
Создайте службы и установите следующее программное обеспечение для локальной среды разработки.
- Поиск ИИ Azure, любой регион или уровень
- .NET 6 или более поздней версии
- Git
- Visual Studio Code
- Расширение средств разработки на C# для Visual Studio Code
- Расширение статического веб-приложения Azure для Visual Studio Code
В этом руководстве не выполняется API-интерфейс функции Azure локально, но если вы планируете запустить его локально, установите azure-functions-core-tools.
Разветвление и клонирование примера поиска с помощью Git
Разветвление примера репозитория очень важно для развертывания статического веб-приложения. Веб-приложения определяют действия сборки и содержимое развертывания на основе вашего расположения разветвления GitHub. Выполнение кода в статическом веб-приложении осуществляется удаленно. При этом статические веб-приложения Azure считываются из кода в разветвленном примере.
В GitHub вилку репозитория azure-search-static-web-app.
Выполните процесс вилки в веб-браузере с помощью учетной записи GitHub. В этом учебнике используется равилка как часть развертывания в статическом веб-приложении Azure.
В терминале Bash скачайте вилку примера приложения на локальный компьютер.
Замените
YOUR-GITHUB-ALIASпсевдонимом записи GitHub.git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-static-web-app.gitВ том же терминале Bash перейдите в вилку репозитория для этого примера поиска на веб-сайте:
cd azure-search-static-web-appИспользуйте команду Visual Studio Code,
code .чтобы открыть вилку репозитория. Оставшиеся задачи выполняются в Visual Studio Code, если не указано иное.code .