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

Внимание

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

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

Вы можете создавать псевдонимы и управлять ими в службе поиска ИИ Azure с помощью HTTP-запросов (POST, GET, PUT, DELETE) для заданного ресурса псевдонима. Псевдонимы — это ресурсы уровня обслуживания и поддерживаются независимо от индексов поиска. После создания индекса поиска можно создать псевдоним, который сопоставляется с этим индексом поиска.

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

POST /indexes/hotel-samples-index/docs/search?api-version=2025-11-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-11-01-preview
{
    "search": "pool spa +airport",
    "select": "HotelId, HotelName, Category, Description",
    "count": true
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Получение определения псевдонима

Этот запрос возвращает список существующих объектов псевдонима по имени.

GET https://[service name].search.windows.net/aliases?api-version=[api-version]&$select=name
api-key: [admin key]

Этот запрос возвращает определение псевдонима

GET https://[service name].search.windows.net/aliases/my-alias?api-version=[api-version]
api-key: [admin key]

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

Наиболее распространенное обновление псевдонима — изменение имени индекса при замене базового индекса более новой версией.

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

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

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

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

См. также

  • Last updated on