Шаг 1. Обзор добавления поиска на веб-сайт с помощью .NET

В этом руководстве создается веб-сайт для поиска по каталогу книг, а затем развертывается веб-сайт в статическом веб-приложении Azure.

Как работает пример?

Этот пример веб-сайта предоставляет доступ к каталогу, содержащему 10 000 книг. Пользователь может выполнять поиск в каталоге, вводя текст на панели поиска. Пока пользователь вводит текст, веб-сайт использует функцию предложения индекса поиска для завершения текста. После завершения запроса отображается список книг с частью сведений. Пользователь может выбрать книгу, чтобы просмотреть все сведения, хранящиеся в индексе поиска книги.

Возможности поиска включают в себя:

• Поиск — предоставляет функции поиска для приложения.
• Предложение — предоставляет предложения по мере ввода текста пользователем в строке поиска.
• Аспекты и фильтры — предоставляет фасетную структуру навигации, которая фильтрует по автору или языку.
• Результаты с разбивкой на страницы — предоставляют элементы управления разбиением на страницы для прокрутки результатов.
• Поиск документов — выполняет поиск документа по идентификатору, чтобы получить все его содержимое на странице сведений.

Какова структура примера?

Пример кода содержит следующие папки:

Настройка среды разработки

Установите следующее программное обеспечение для локальной среды разработки.

• .NET 6 или более поздней версии
• Git
• Visual Studio Code и следующие расширения
  • Статическое веб-приложение Azure
  • Используйте интегрированный терминал для операций командной строки.
• Дополнительные:
  • В рамках этого учебника API Функций Azure не запускается локально, но если вы планируете запустить его локально, необходимо установить azure-functions-core-tools.

Разветвление и клонирование примера поиска с помощью Git

Разветвление примера репозитория очень важно для развертывания статического веб-приложения. Веб-приложения определяют действия сборки и содержимое развертывания на основе вашего расположения разветвления GitHub. Выполнение кода в статическом веб-приложении осуществляется удаленно. При этом статические веб-приложения Azure считываются из кода в разветвленном примере.

1. В GitHub создайте разветвление примера репозитория.

   Завершите процесс разветвления в веб-браузере с помощью учетной записи GitHub. В этом учебнике используется равилка как часть развертывания в статическом веб-приложении Azure.

2. В терминале Bash скачайте вилку примера приложения на локальный компьютер.

   Замените YOUR-GITHUB-ALIAS псевдонимом записи GitHub.

   git clone https://github.com/YOUR-GITHUB-ALIAS/azure-search-dotnet-samples
   

3. В том же терминале Bash перейдите в вилку репозитория для этого примера поиска на веб-сайте:

   cd azure-search-dotnet-samples
   

4. Используйте команду Visual Studio Code, code . чтобы открыть вилку репозитория. Оставшиеся задачи выполняются в Visual Studio Code, если не указано иное.

   code .
   

Создайте группу ресурсов для ресурсов Azure.

1. В Visual Studio Code откройте панель действий и выберите значок Azure.

2. Войдите в Azure, если вы еще не вошли в систему.

3. В разделе "Ресурсы" выберите "Добавить" (+), а затем выберите "Создать группу ресурсов".

   

4. Введите имя группы ресурсов, например cognitive-search-demo-rg.

5. Введите регион:

   • Для Node.js выберите West US 2. Это рекомендуемый регион для предварительной версии 4 модели программирования функций Azure (PM).
   • Для C# и Python рекомендуется использовать следующие регионы, поддерживаемые Статические веб-приложения Azure по состоянию на этот текст: West US 2, , East US 2West EuropeCentral USEast Asia

Используйте эту группу ресурсов для всех ресурсов, созданных во время работы с этим руководством. Группа ресурсов предоставляет логическую единицу для управления ресурсами, включая удаление их после завершения.

Следующие шаги

• Создание индекса поиска и загрузка документов
• Развертывание статического веб-приложения