Adlandırma kuralları (Azure AI Search)

Bu bölümde Azure AI Search için 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, 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.

Name Uzunluk Case (Olay) İzin verilebilen karakterler Karakter yerleşimi Örnek
Hizmet 2 - 60 Daha az Harfler, sayılar, kısa çizgiler (-) Birinci, ikinci ve son karakterler bir harf veya sayı olmalıdır.

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

Ardışık tire veya alt çizgi yok
idx-hotels-2024
Alan 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 tuşlar için ayırıcı olarak tire, alt çizgi veya eşittir işareti kullanmanızı öneririz.

Anahtarlar başka simgeler içeriyorsa, Base64'ün URL'si güvenli bir değişkenini kullanarak bunları 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 sorunlu 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 Daha az Harfler, sayılar, kısa çizgiler (-) İlk ve son karakter bir harf veya sayı olmalıdır. docdbds-onlinecatalog-20240228
Dizin Oluşturucu 1 -128 Daha az Harfler, sayılar, kısa çizgiler (-) İlk ve son karakter bir harf veya sayı olmalıdır. docbindxr-onlinecatalog-20240228
Eş anlamlı eşlem 1 -128 Daha az Harfler, sayılar, kısa çizgiler (-) İlk ve son karakter bir harf veya sayı olmalıdır. özel eş anlamlılar-2024
Beceri Kümesi 1 -128 Daha az Harfler, sayılar, kısa çizgiler (-) İlk ve son karakter bir harf veya sayı olmalıdır. grok-myfiles-skillset-1

Ayrıca bkz.