Aturan penamaan (Pencarian Azure AI)
Bagian ini menjelaskan aturan penamaan untuk Azure AI Search.
Bagan aturan penamaan
Konvensi bervariasi menurut objek karena bagaimana objek digunakan. Aturan penamaan standar lain diberlakukan pada objek Pencarian Azure AI tertentu. URL dan JSON memiliki konvensi yang berbeda dalam hal sensitivitas huruf besar/kecil, karakter khusus, dan penempatan karakter. Berdasarkan kebutuhan, objek yang dirujuk dalam URL (nama host, jalur, atau string kueri) atau isi permintaan JSON harus mengikuti konvensi penamaan standar yang berlaku.
| 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 di mana saja. |
contoso-srch1 |
| Indeks | 2 - 128 | Lebih rendah | Huruf, angka, garis putus-putus (-), garis bawah (_) |
Karakter pertama harus berupa huruf atau angka. Tidak ada garis putus-putus atau garis bawah berturut-turut |
idx-hotels-2024 |
| 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 simbol lain, sebaiknya kodekan 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= String "Contoh kunci dokumen" dikodekan dalam 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-20240228 |
| Pengindeks | 1 -128 | Lebih rendah | Huruf, angka, garis putus-putus (-) |
Karakter pertama dan terakhir harus berupa huruf atau angka. | docbindxr-onlinecatalog-20240228 |
| Peta sinonim | 1 -128 | Lebih rendah | Huruf, angka, garis putus-putus (-) |
Karakter pertama dan terakhir harus berupa huruf atau angka. | custom-synonyms-2024 |
| Skillset | 1 -128 | Lebih rendah | Huruf, angka, garis putus-putus (-) |
Karakter pertama dan terakhir harus berupa huruf atau angka. | grok-myfiles-skillset-1 |