Создание псевдонима индекса в службе "Поиск ИИ Azure"

  • Статья

Важно!

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

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

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

Вместо удаления и перестроения индекса можно использовать псевдонимы индексов. Типичный рабочий процесс должен быть следующим:

  1. Создание индекса поиска
  2. Создание псевдонима, который сопоставляется с индексом поиска
  3. Отправлять или индексировать запросы приложения псевдониму, а не имени индекса.
  4. Когда необходимо внести изменения в индекс, требующий перестроения, создайте новый индекс поиска.
  5. Когда новый индекс будет готов к переходу, обновите псевдоним для сопоставления с новым индексом и запросы будут автоматически перенаправлены в новый индекс.

Создание псевдонима индекса

Псевдоним можно создать с помощью REST API предварительной версии, пакетов SDK предварительной версии или портал Azure. Псевдоним состоит из name псевдонима и имени индекса поиска, с которым сопоставляется псевдоним. В массиве indexes можно указать только одно имя индекса.

Для создания псевдонима индекса можно использовать псевдоним создания или обновления (предварительная версия REST).

POST /aliases?api-version=2023-10-01-preview
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index"]
}

Отправка запросов в псевдоним индекса

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

В приведенном ниже запросе вместо отправки запроса вместо отправки запроса hotel-samples-indexможно отправить запрос my-alias и он будет перенаправлен соответствующим образом.

POST /indexes/my-alias/docs/search?api-version=2023-10-01-preview
{
    "search": "pool spa +airport",
    "searchMode": any,
    "queryType": "simple",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

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

Примечание.

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

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

Переключение индексов

Теперь, когда необходимо обновить приложение, чтобы указать на новый индекс, все, что необходимо сделать, — обновить сопоставление в псевдониме. PUT требуется для обновлений, как описано в статье "Создание или обновление псевдонима ( предварительная версия REST)".

PUT /aliases/my-alias?api-version=2023-10-01-preview
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index2"]
}

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

Примечание.

Обновление псевдонима может занять до 10 секунд для распространения по системе, поэтому перед удалением индекса, с которым ранее сопоставлен псевдоним, следует подождать не менее 10 секунд.

См. также