Aturan penamaan (Azure Cognitive Search)

Bagian ini menjelaskan aturan penamaan untuk layanan Azure Cognitive Search, indeks, bidang, kunci dokumen, profil penilaian, saran, peta sinonim, pengindeks, sumber data, dan set keterampilan.

Bagan aturan penamaan

Anda akan melihat bahwa konvensi dalam tabel berikut ini tidak konsisten ke bawah baris untuk semua objek. Ini karena objek digunakan dalam konteks yang berbeda, di mana aturan penamaan standar lain diberlakukan pada objek Azure Cognitive Search tertentu. URL, JSON, dan DNS semuanya memiliki konvensi yang berbeda dalam hal sensitivitas huruf besar/kecil, karakter khusus, dan penempatan karakter. Berdasarkan kebutuhan, objek yang direferensikan dalam URL (nama host, jalur, atau string kueri) atau isi permintaan JSON harus mengikuti konvensi penamaan standar yang berlaku, sehingga memperhitungkan variasi yang Anda lihat di bawah ini.

Nama Panjang Kasus Karakter yang diperbolehkan Penempatan karakter Contoh
Layanan 2 - 60 Lebih rendah Huruf, angka, garis putus-putus ("-") Karakter pertama, kedua, dan terakhir harus berupa huruf atau angka.

Tidak ada tanda hubung berturut-turut.
contoso-srch1
Indeks 2 - 128 Lebih rendah Huruf, angka, garis putus-putus ("-") Karakter pertama harus berupa huruf atau angka.

Tidak ada tanda hubung berturut-turut.
idx-hotels-2015
Bidang 1 -128 Atas atau bawah Huruf, angka, garis bawah ("_") Karakter pertama harus berupa huruf.

Nama tidak dapat dimulai dengan "azureSearch".
Store_Name
Kunci dokumen 1024 Atas atau bawah Huruf, angka, garis putus-putus ("-"), garis bawah ("_"), tanda sama dengan ("=")

Untuk kunci majemuk, sebaiknya gunakan tanda hubung, garis bawah, atau tanda sama dengan sebagai pemisah.

Jika kunci berisi karakter selain di atas, kami sarankan untuk mengodekannya menggunakan varian Base64 yang aman URL. Misalnya, di .NET Anda dapat menggunakan metode HttpServerUtility.UrlTokenEncode untuk tujuan ini.
Karakter pertama tidak boleh berupa garis bawah. RXhhbXBsZSBkb2N1bWVudCBrZXk=

Ini adalah string "Contoh kunci dokumen" yang dikodekan di basis 64. Pengodean Base64 url-safe direkomendasikan karena kunci dokumen terkadang digunakan di jalur URL. Pengodean memungkinkan Anda menggunakan karakter dalam kunci dokumen yang jika tidak akan bermasalah dalam URL.
Profil penilaian 1 - 128 Atas atau bawah Huruf, angka, garis bawah ("_") Karakter pertama harus berupa huruf atau angka. BoostFunc_TagsCustHist
Saran 1 - 128 Atas atau bawah Huruf, angka, garis bawah ("_") Karakter pertama harus berupa huruf atau angka. Sugst01_Apparel
Sumber data 1 - 128 Lebih rendah Huruf, angka, garis putus-putus ("-") Karakter pertama dan terakhir harus berupa huruf atau angka. docdbds-onlinecatalog-20150228
Pengindeks 1 -128 Lebih rendah Huruf, angka, garis putus-putus ("-") Karakter pertama dan terakhir harus berupa huruf atau angka. docbindxr-onlinecatalog-20150228
Peta sinonim 1 -128 Lebih rendah Huruf, angka, garis putus-putus ("-") Karakter pertama dan terakhir harus berupa huruf atau angka. custom-synonyms-15
Skillset 1 -128 Lebih rendah Huruf, angka, garis putus-putus ("-") Karakter pertama dan terakhir harus berupa huruf atau angka. grok-myfiles-skillset-1

Lihat juga