Adlandırma kuralları (Azure AI Search)

Bu bölümde Azure AI Search adlandırma kuralları açıklanmaktadır.

Adlandırma kuralları grafiği

Kurallar, nesnelerin nasıl kullanıldığına bağlı olarak nesneye göre farklılık gösterir. Diğer standartların adlandırma kuralları belirli Azure AI Search nesnelerine uygulanır. URL'ler ve JSON'lar büyük/küçük harf duyarlılığı, özel karakterler ve karakter yerleşimi açısından farklı kurallar içerir. Gerektiğinde, BIR URL'de (ana bilgisayar adı, yol veya sorgu dizesi) veya JSON istek gövdesinde başvuruda bulunılan nesneler, ilgili standardın adlandırma kurallarına uygun olmalıdır.

İsim Uzunluk Durum İzin verilebilen karakterler Karakter yerleşimi Örnek
Hizmet 2 - 60 Alt Harfler, sayılar, tireler (-) İlk, ikinci ve son karakterler bir harf veya sayı olmalıdır.

Hiçbir yerde ardışık tire yok.
contoso-srch1
Dizin 2 - 128 Alt Harfler, sayılar, tireler (-), alt çizgi (_) İlk karakter bir harf veya sayı olmalıdır.

Ardışık tire veya alt çizgi yok
idx-hotels-2024
Saha 1 -128 Üst veya alt Harfler, sayılar, alt çizgiler (_) İlk karakter bir harf olmalıdır.

Ad "azureSearch" ile başlayamaz.
Store_Name
Belge anahtarı 1024 Üst veya alt Harfler, sayılar, tireler (-), alt çizgi (_), eşittir işaretleri (=)

Bileşik anahtarlar için ayırıcı olarak tire, alt çizgi veya eşittir işareti kullanmanızı öneririz.

Anahtarlar başka simgeler içeriyorsa, bunları Base64'ün URL'si güvenli bir değişkenini kullanarak kodlamanızı öneririz. Örneğin, .NET'te bu amaçla HttpServerUtility.UrlTokenEncode yöntemini kullanabilirsiniz.
İlk karakter alt çizgi olamaz. RXhhbXBsZSBkb2N1bWVudCBrZXk=

64 tabanında kodlanmış "Örnek belge anahtarı" dizesi. Belge anahtarları bazen URL yolunda kullanıldığından URL güvenli Base64 kodlaması önerilir. Kodlama, belge anahtarındaki karakterleri kullanmanıza olanak tanır; aksi takdirde URL'de sorun olabilir.
Puanlama profili 1 - 128 Üst veya alt Harfler, sayılar, alt çizgiler (_) İlk karakter bir harf veya sayı olmalıdır. BoostFunc_TagsCustHist
Öneri oluşturucu 1 - 128 Üst veya alt Harfler, sayılar, alt çizgiler (_) İlk karakter bir harf veya sayı olmalıdır. Sugst01_Apparel
Veri kaynağı 1 - 128 Alt Harfler, sayılar, tireler (-) İlk ve son karakter bir harf veya sayı olmalıdır. docdbds-onlinecatalog-20240228
Dizinleyici 1 -128 Alt Harfler, sayılar, tireler (-) İlk ve son karakter bir harf veya sayı olmalıdır. docbindxr-onlinecatalog-20240228
Eş anlamlı harita 1 -128 Alt Harfler, sayılar, tireler (-) İlk ve son karakter bir harf veya sayı olmalıdır. custom-synonyms-2024
Beceri Kümesi 1 -128 Alt Harfler, sayılar, tireler (-) İlk ve son karakter bir harf veya sayı olmalıdır. grok-myfiles-skillset-1

Ayrıca bkz.