Создание псевдонима индекса в Когнитивный поиск Azure

Важно!

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

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

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

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

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

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

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

Use the Application Insights REST API to build custom solutions

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

POST /aliases?api-version=2021-04-30-preview
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index"]
}

Visual Studio Code

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

1. Выполните действия, описанные в кратком руководстве по Visual Studio Code, чтобы установить расширение Когнитивный поиск Azure и подключиться к подписке Azure.

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

3. В службе поиска щелкните правой кнопкой мыши псевдоним и выберите "Создать новый псевдоним".

4. Укажите имя псевдонима и имя индекса поиска, с который вы хотите сопоставить его, а затем сохраните файл для создания псевдонима.

   

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

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

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

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

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

Примечание

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

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

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

PUT /aliases/my-alias?api-version=2021-04-30-preview
{
    "name": "my-alias",
    "indexes": ["hotel-samples-index2"]
}

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

Примечание

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

См. также:

• Удаление и перестроение индекса в Когнитивный поиск Azure