Azure AI Search'te dizin diğer adı oluşturma

  • Makale

Önemli

Dizin diğer adları şu anda genel önizleme aşamasındadır ve ek kullanım koşulları altında kullanılabilir.

Azure AI Search'te dizin diğer adı, sorgulama, dizin oluşturma ve diğer işlemler için bir dizine başvurmak için kullanılabilecek ikincil bir addır. Bir arama dizinine eşleyen bir diğer ad oluşturabilir ve diğer adı başka bir dizin adına başvuracağınız yerlerde değiştirebilirsiniz. Uygulamanızın işaret ettiği dizini değiştirmeniz gerekiyorsa diğer ad esneklik ekler. Uygulamanızdaki başvuruları güncelleştirmek yerine diğer adınızın eşlemesini güncelleştirebilirsiniz.

Dizin diğer adlarının ana hedefi, üretim dizinlerinizi yönetmeyi kolaylaştırmaktır. Örneğin, alan düzenleme veya yeni çözümleyici ekleme gibi dizin tanımınızda değişiklik yapmanız gerekiyorsa, tüm arama dizinleri sabit olduğundan yeni bir arama dizini oluşturmanız gerekir. Bu, dizininizi bırakmanız ve yeniden oluşturmanız veya yeni bir dizin oluşturmanız ve ardından uygulamanızı bu dizine geçirmeniz gerektiği anlamına gelir.

Dizininizi bırakmak ve yeniden oluşturmak yerine dizin diğer adlarını kullanabilirsiniz. Tipik bir iş akışı şu şekilde olabilir:

  1. Arama dizininizi oluşturma
  2. Arama dizininize eşleyen bir diğer ad oluşturma
  3. Uygulamanızın dizin adı yerine diğer ada sorgulama/dizin oluşturma istekleri göndermesini sağlama
  4. Dizininizde yeniden oluşturma gerektiren bir değişiklik yapmanız gerektiğinde yeni bir arama dizini oluşturun
  5. Yeni dizininiz kullanıma hazır olduğunda, diğer adı yeni dizine eşlenecek şekilde güncelleştirin; istekler otomatik olarak yeni dizine yönlendirilir

Diğer ad dizini oluşturma

Önizleme REST API'sini, önizleme SDK'larını kullanarak veya Azure portalı aracılığıyla 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ı belirtilebilir.

Dizin diğer adı oluşturmak için Diğer Ad Oluştur veya Güncelleştir 'i (REST önizlemesi) kullanabilirsiniz.

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

Dizin diğer adına istek gönderme

Diğer adınızı oluşturduktan sonra kullanmaya başlayabilirsiniz. Diğer adlar sorgulama, dizin oluşturma, öneriler ve otomatik tamamlama gibi tüm belge işlemleri için kullanılabilir.

Aşağıdaki sorguda, isteği adresine hotel-samples-indexgöndermek yerine adresine gönderebilirsiniz my-alias ve buna göre yönlendirilir.

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

Bir üretim dizininde güncelleştirmeler yapmayı bekliyorsanız, istemci tarafı uygulamanızda dizin adı yerine bir diğer ad belirtin. Dizin yeniden derlemesi gerektiren senaryolar, Dizini bırakma ve yeniden derleme bölümünde özetlenmiştir.

Not

Diğer adı yalnızca belge işlemleriyle veya dizin tanımını alıp güncelleştirmek için kullanabilirsiniz. Diğer adlar bir dizini silmek için kullanılamaz, Metin Analizi API'siyle kullanılamaz ve dizin oluşturucuda targetIndexName olarak kullanılamaz.

Bir diğer ad güncelleştirmesinin sisteme yayılması 10 saniye kadar sürebilir, bu nedenle dizinde eşlenmiş veya yakın zamanda diğer adla eşlenmiş herhangi bir işlemi gerçekleştirmeden önce en az 10 saniye beklemeniz gerekir.

Dizinleri değiştirme

Şimdi, uygulamanızı yeni bir dizine işaret etmek için güncelleştirmeniz gerektiğinde, tek yapmanız gereken diğer adınızdaki eşlemeyi güncelleştirmektir. PUT, Diğer Ad Oluşturma veya Güncelleştirme (REST önizleme) bölümünde açıklandığı gibi güncelleştirmeler için gereklidir.

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

Diğer ad güncelleştirmesini yaptıktan sonra istekler otomatik olarak yeni dizine yönlendirilmeye başlar.

Not

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 beklemeniz gerekir.

Ayrıca bkz.