Создание псевдонима индекса в Поиск с использованием ИИ Azure

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

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

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

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

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

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

Необходимые условия

• Служба Поиск с использованием ИИ Azure в любом регионе и ценовой категории.
• Существующий индекс поиска , с которым требуется сопоставить псевдоним.
• Разрешения для создания псевдонима:
  • Для аутентификации на основе ключа используйте ключ API администратора для вашей службы поиска.
  • Для проверки подлинности на основе ролей роль участника службы поиска .

Ограничения и рекомендации

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

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

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

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

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

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

// Create a SearchIndexClient
SearchIndexClient adminClient = new SearchIndexClient(serviceEndpoint, credential);

// Create an index alias
SearchAlias myAlias = new SearchAlias("my-alias", "hotel-samples-index");
adminClient.CreateAlias(myAlias);

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

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

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

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

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

Используйте псевдонимы — список (REST API), чтобы вернуть список существующих объектов псевдонимов по имени.

GET /aliases?api-version=2026-04-01&$select=name

Используйте псевдонимы — Get (REST API) для возврата определения определенного псевдонима.

GET /aliases/my-alias?api-version=2026-04-01

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

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

Используйте псевдонимы— создание или обновление (REST API) для обновления псевдонима. В следующем примере показано, как обновить my-alias, чтобы он указывал на hotel-samples-index2 вместо hotel-samples-index.

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

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

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

Связанное содержимое

• Удалите и восстановите индекс в Поиск с использованием ИИ Azure