Поделиться через

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

Внимание

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

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

Перед использованием псевдонима приложение отправляет запросы непосредственно в hotel-samples-index.

POST /indexes/hotel-samples-index/docs/search?api-version=2025-05-01-preview
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

После использования псевдонима ваше приложение отправляет запросы на my-alias, который сопоставляется с hotel-samples-index.

POST /indexes/my-alias/docs/search?api-version=2025-05-01-preview
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

Поддерживаемые сценарии

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

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

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

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

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

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

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

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

Этот запрос отправляет my-alias, сопоставленный с настоящим индексом в службе поиска.

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

Обновление псевдонима

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

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

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

См. также