Azure Yapay Zeka Arama'te dizin takma adı oluşturma

Azure Yapay Zeka Arama'te, bir dizin takma adı, bir arama dizini için ikincil bir addır. Bir arama dizinine eşlenen bir diğer ad oluşturabilir ve daha sonra, dizin adına referans vereceğiniz yerlerde bu diğer adı kullanabilirsiniz. Bu özellik, uygulamanızın işaret ettiği dizini değiştirmeniz gerekiyorsa esneklik sağlar. Üretim kodunda dizin adına yapılan başvuruları güncellemek yerine, alias eşlemesini güncelleyebilirsiniz.

Belirli bir takma ad kaynağına karşı HTTP istekleri (POST, GET, PUT veya DELETE) kullanarak arama hizmetinde takma adlar oluşturabilir ve yönetebilirsiniz. Takma adlar, arama dizinlerinden bağımsız olarak tutulan hizmet düzeyi kaynaklardır. Arama dizini oluşturduktan sonra, buna eşleyen bir diğer ad oluşturabilirsiniz.

Bir diğer adı kullanmadan önce, uygulamanız istekleri doğrudan hotel-samples-index adresine gönderir.

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

Bir diğer ad kullandıktan sonra, uygulamanız my-alias ile eşlenen hotel-samples-index'e istekler gönderir.

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

Önkoşullar

• Herhangi bir bölgede ve fiyatlandırma katmanında Azure Yapay Zeka Arama hizmeti.
• Mevcut bir arama dizini ile eşleştirmek istediğiniz takma ad.
• Bir takma ad oluşturma izinleri
  • Anahtar tabanlı kimlik doğrulaması için, arama hizmetiniz için bir yönetici API anahtarı .
  • Rol tabanlı kimlik doğrulaması için Arama Hizmeti Katkıda Bulunanı rolü.

Sınırlamalar ve dikkat edilmesi gerekenler

• Yalnızca bir diğer ad kullanarak belge operasyonları yapabilir veya bir dizin tanımını alıp güncelleştirebilirsiniz.
• Bir dizini silmek veya metin belirtecini test etmek için diğer ad kullanamazsınız.
• Diğer adlara targetIndexName olarak bir dizin oluşturucu veya bilgi kaynağı başvuramazsınız.

Bir dizin takma adı oluştur

Bir diğer ad oluşturmak, diğer adla endeks adı arasında bir eşleme kurar. İstek başarılı olursa dizin oluşturma, sorgulama ve diğer işlemler için diğer adı kullanabilirsiniz.

REST API, Azure SDK’ları veya Azure portalını kullanarak bir diğer ad oluşturabilirsiniz. Diğer ad, name diğer adın ve diğer adın eşlendiği arama dizininin adından oluşur. Dizide indexes yalnızca bir dizin adı belirtebilirsiniz.

Oluşturabileceğiniz en fazla takma ad sayısı, fiyatlandırma katmanına göre değişir. Daha fazla bilgi için Dizin takma ad kısıtlamaları'na bakın.

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);

Dizin diğer adına istek gönderme

Sorgulama, dizin oluşturma, öneriler ve otomatik tamamlama gibi tüm belge işlemleri için bir diğer ad kullanabilirsiniz.

Aşağıdaki sorgu, arama hizmetinizdeki gerçek bir dizine eşlenen isteği my-aliasadresine gönderir.

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
}

Takma ad tanımı edin

Mevcut diğer ad nesnelerinin listesini isimlerine göre döndürmek için Diğer Adlar - Liste (REST API) kullanın.

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

Belirli bir takma adın tanımını döndürmek için Takma Adlar - Get (REST API) kullanın.

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

Bir takma adı güncelle

Bir alias’a yapılan en yaygın güncelleme, temel alınan dizin daha yeni bir sürümle değiştirildiğinde dizin adını değiştirmektir.

Diğer Adlar - Oluştur veya Güncelle (REST API) ile bir diğer adı güncelleyin. Aşağıdaki örnek, my-alias'nin hotel-samples-index2 yerine hotel-samples-index'e işaret edecek şekilde nasıl güncellenebileceğini göstermektedir.

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

Diğer ad güncelleştirmesinin sisteme yayılması 10 saniye kadar sürebilir, bu nedenle diğer adın daha önce eşlendiği dizini silmeden önce en az 10 saniye bekleyin.

Şu anda bir diğer adla eşlenmiş bir dizini silmeye çalışırsanız, işlem başarısız olur ve 400 (Hatalı İstek) ile şu hatayı alırsınız: Silmek istediğiniz dizinle eşlenmiş olan diğer adların, önce silinmesi veya başka bir dizine eşlenmesi gerekmektedir.

İlgili içerik

• Azure Yapay Zeka Arama dizinini sil ve yeniden oluştur