Краткое руководство: Полнотекстовый поиск на портале Azure

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

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

Предварительные условия

• Учетная запись Azure с активной подпиской. Создайте учетную запись бесплатно .

• Служба Поиск с использованием ИИ Azure. В этом кратком руководстве требуется уровень "Базовый" или более высокий для поддержки управляемых удостоверений. Управляемая идентичность используется для безопасной аутентификации без ключей между Поиск с использованием ИИ Azure и источниками данных индексатора.

• Учетная запись служба хранилища Azure. Используйте Хранилище BLOB-объектов Azure или Azure Data Lake Storage 2-го поколения (учетная запись хранения с иерархическим пространством имен) в учетной записи стандартной производительности (общего назначения версии 2). Чтобы избежать расходов на пропускную способность, используйте тот же регион, что и Поиск с использованием ИИ Azure.

• Знакомство с мастером. См. мастер импорта данных на портале Azure.

Проверка доступа к сети

Все предыдущие ресурсы должны иметь общедоступный доступ, чтобы мастер смог получить к ним доступ. В противном случае мастер завершается ошибкой. После запуска мастера можно включить брандмауэры и частные конечные точки в компонентах интеграции для обеспечения безопасности. Дополнительные сведения см. в разделе "Безопасные подключения" в мастере импорта.

Проверка пространства

Многие клиенты начинают с бесплатной службы поиска, которая ограничена тремя индексами, тремя индексаторами и тремя источниками данных. В этом кратком руководстве создается один из них, поэтому перед началом работы убедитесь, что у вас есть место для дополнительных объектов.

На странице "Обзор" выберите "Использование" , чтобы узнать, сколько индексаторов, индексаторов и источников данных сейчас есть.

Настройка доступа

Перед началом работы убедитесь, что у вас есть разрешения на доступ к содержимому и операциям. В этой быстрой настройке используется Microsoft Entra ID для аутентификации и доступа с авторизацией на основе ролей. Для назначения ролей необходимо быть владельцем или администратором доступа пользователей . Если роли недоступны, используйте аутентификацию по ключу.

Чтобы настроить доступ для этого краткого руководства, выполните указанные ниже действия.

1. Войдите на портал Azure.

2. В службе Поиск с использованием ИИ Azure:

   1. Включите доступ на основе ролей.

   2. Создайте управляемую идентификацию, назначаемую системой.

   3. Назначьте следующие роли учетной записи пользователя: участник службы поиска, участник данных индекса поиска и средство чтения данных индексов поиска.

3. В учетной записи служба хранилища Azure назначьте Storage Blob Data Reader управляемому удостоверению поисковой службы.

Подготовка примера данных

В этом кратком руководстве используется пример документа JSON, содержащего метаданные для 50 вымышленных отелей, но вы также можете использовать собственные файлы.

Чтобы подготовить примеры данных для этого краткого руководства:

1. Перейдите к учетной записи хранения Azure на портале Azure.

2. В левой области выберитеконтейнеры> данных.

3. Создайте контейнер с именем hotels-sample-data.

4. Загрузите образец документа JSON в контейнер.

Запуск мастера

1. Перейдите в службу поиска в портал Azure.

2. На странице "Обзор" выберите "Импорт данных".

   

3. Выберите источник данных: Хранилище BLOB-объектов Azure или Azure Data Lake Storage 2-го поколения.

   

4. Выберите поиск ключевых слов.

   

Запуск мастера

Мастер описывает несколько этапов настройки. В этом разделе рассматриваются все этапы последовательности.

Подключение к источникам данных

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

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

1. На странице Подключение к вашим данным выберите подписку Azure.

2. Выберите аккаунт хранилища, а затем выберите контейнер hotels-sample-data.

3. Выберите массив JSON для режима синтаксического анализа.

4. Установите флажок "Проверка подлинности с помощью управляемого удостоверения ". Оставьте тип удостоверения назначенным системой.

   

5. Нажмите кнопку Далее.

Пропуск обогащения ИИ

Мастер поддерживает создание набора навыков и обогащение ИИ во время индексирования , которые выходят за рамки этого краткого руководства. Пропустите этот шаг, нажав кнопку "Далее".

Настройка индекса

Мастер создает схему для индекса поиска на основе примеров данных. Как минимум, индексу требуется имя и коллекция полей. Мастер сканирует уникальные строковые поля и помечает его как ключ документа, который однозначно идентифицирует каждый документ в индексе.

Каждое поле имеет имя, тип данных и атрибуты, которые управляют тем, как он используется. Например, поля, поддерживающие фильтрацию , поддерживают выражения фильтров в запросах, а поля, доступные для поиска , поддерживают поиск ключевых слов. Дополнительные сведения см. в разделе "Настройка определений полей".

Для настройки индекса примеров запросов в этом кратком руководстве:

1. Для каждого из следующих полей выберите "Настроить" и задайте соответствующие атрибуты.

   Fields	Attributes
   HotelId	Ключ, извлекаемый, фильтруемый, сортируемый, доступный для поиска
   HotelName, Category	Извлекаемые, фильтруемые, сортируемые, доступные для поиска
   Description, Description_fr	Извлекаемый, доступный для поиска
   Tags	Извлекаемый, фильтруемый, доступный для поиска
   ParkingIncluded, IsDeleted	Извлекаемый, фильтруемый, поддающийся фасетированию
   LastRenovationDate Rating Location	Извлекаемый, фильтруемый, сортируемый
   Address.StreetAddress Rooms.Description Rooms.Description_fr	Извлекаемый, доступный для поиска
   Address.City Address.StateProvince Address.PostalCode Address.Country	Извлекаемые, фильтруемые, фасетные, доступные для поиска, сортируемые
   Rooms.Type Rooms.BedOptions Rooms.Tags	Извлекаемая, фильтруемая, фасетируемая, поисково-ориентированная
   Rooms.BaseRate Rooms.SleepsCount Rooms.SmokingAllowed	Извлекаемый, фильтруемый, поддающийся фасетированию

   

2. Нажмите кнопку Далее.

Пропуск дополнительных параметров

Мастер предлагает дополнительные параметры для семантического ранжирования и планирования индексов, которые выходят за рамки этого краткого руководства. Пропустите этот шаг, нажав кнопку "Далее".

Завершение работы мастера

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

Чтобы завершить работу мастера, выполните следующие действия.

1. Измените префикс имени объекта на hotels-sample.

2. Просмотрите конфигурации объектов.

   

   Обогащение ИИ, семантическая сортировка и планирование индексатора отключены или установлены по умолчанию, так как вы пропустили шаги мастера настройки.

3. Выберите "Создать ", чтобы одновременно создать объекты и запустить индексатор.

Проверка состояния индексатора

1. В левой области выберите управление поиском>индексаторы.

2. Найдите hotels-sample-indexer в списке.

   

   Для обновления результатов может потребоваться несколько минут. Вы увидите только что созданный индексатор с состоянием "Выполняется " или "Успешно". В списке также отображается количество индексированных документов.

Проверка результатов индекса

1. В левой области выберите управление поиском>индексы.

2. Выберите пример отелей. Если в индексе нет документов или хранилища, дождитесь обновления портала Azure.

   

3. Перейдите на вкладку "Поля", чтобы просмотреть схему индекса.

   &&&&Скриншот, показывающий определение схемы для индекса в службе Поиск с использованием ИИ Azure на портале Azure.&&&&

Добавление или изменение полей индекса

На вкладке "Поля" можно создать поле, выбрав " Добавить поле " и указав имя, поддерживаемый тип данных и атрибуты.

Изменение существующих полей сложнее. Существующие поля имеют физическое представление в индексе поиска, поэтому они не изменяются даже в коде. Чтобы изменить существующее поле, необходимо создать новое поле для замены исходного. Вы можете добавлять другие конструкции, такие как профили оценки и семантическая конфигурация, в индекс в любое время.

Просмотрите параметры определения индекса, чтобы понять, что можно и не удается изменить во время разработки индекса. Если параметр отображается неактивным, его нельзя изменить или удалить.

Запросить индекс

Теперь у вас есть индекс поиска, который можно запросить с помощью Search Explorer, который отправляет вызовы REST, соответствующие Documents - Search POST (REST API). Это средство поддерживает простой синтаксис запросов и полный синтаксис запросов Lucene для поиска ключевых слов.

Чтобы запросить индекс поиска, выполните следующий запрос:

1. На вкладке обозревателя поиска введите термин запроса или строку, например new york hotel with pool or gym.

   

2. Чтобы перейти к невидимым областям выходных данных, используйте мини-карту.

   

3. Чтобы указать синтаксис, переключитесь в представление JSON.

   

4. Выполните следующие примеры запросов, чтобы узнать, как работает фильтрация и синтаксис запросов.

   Совет

   Представление JSON поддерживает intellisense для завершения имени параметра. Поместите курсор в представление JSON и введите пробел, чтобы просмотреть список всех параметров запроса. Можно также ввести букву, например s, чтобы просмотреть только параметры запроса, начинающиеся с этой буквы.

   Intellisense не исключает недопустимые параметры, поэтому используйте собственное усмотрение.

Примеры фильтров

Парковка, теги, дата обновления, рейтинг и расположение можно фильтровать.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "Rating gt 4"
}

Логические фильтры предполагают значение true по умолчанию.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "ParkingIncluded"
}

Геопространственный поиск основан на фильтрах. Функция geo.distance фильтрует все результаты для позиционных данных на основе указанных Location и geography'POINT координат. Запрос ищет отели в пределах пяти километров от координат широты -122.12 47.67и долготы, который является "Редмонд, Вашингтон, США". В запросе отображается общее количество совпадений &$count=true с именами отелей и расположениями адресов.

{
    "search": "*",
    "select": "HotelName, Address/City, Address/StateProvince",
    "count": true,
    "top": 10,
    "filter": "geo.distance(Location, geography'POINT(-122.12 47.67)') le 5"
}

Полные примеры синтаксиса Lucene

Синтаксис по умолчанию является простым синтаксисом, но если требуется нечеткий поиск, повышение терминов или регулярные выражения, укажите полный синтаксис.

{
    "queryType": "full",
    "search": "seatle~",
    "select": "HotelId, HotelName,Address/City, Address/StateProvince",
    "count": true
}

Ошибки в запросах, такие как seatle вместо Seattle, не возвращают совпадения в типичном поиске. Параметр queryType=full вызывает полный синтаксический анализатор запросов Lucene, который поддерживает операнд тильда (~). При использовании этих параметров запрос выполняется с использованием нечетких критериев для указанного ключевого слова и находит соответствия по терминам, которые схожи, но не являются точным совпадением.

Дополнительные сведения об этих примерах см. в разделе Querying в Поиск с использованием ИИ Azure.

Очистка ресурсов

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

На портале Azure выберите All resources или Resource groups на панели слева, чтобы найти ресурсы и управлять ими. Вы можете удалить ресурсы по отдельности или удалить группу ресурсов, чтобы удалить все ресурсы одновременно.

Если вы используете бесплатную службу поиска, помните, что вы ограничены тремя индексами, индексаторами и источниками данных. Вы можете удалить отдельные элементы на портале, чтобы остаться в пределах ограничения.

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

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