Azure AI 搜尋服務 (命名規則)
本節說明 Azure AI 搜尋服務的命名規則。
命名規則的圖表
慣例會因物件的使用方式而有所不同。 其他標準的命名規則會加在特定的 Azure AI 搜尋服務物件上。 URL 和 JSON 在區分大小寫、特殊字元和字元位置方面有不同的慣例。 因此，URL 中所參考的物件 (主機名、路徑或查詢字串) 或 JSON 要求本文必須遵循適用標準的命名慣例。
| 名稱 | 長度 | 案例 | 允許的字元 | 字元位置 | 範例 |
|---|---|---|---|---|---|
| 服務 | 2 - 60 | 較低 | 字母、數位、連字元 (-) |
第一個、第二個和最後一個字元必須是字母或數位。 任何位置都沒有任何連續虛線。 |
contoso-srch1 |
| 索引 | 2 - 128 | 較低 | 字母、數位、虛線 (-) 、底線 (_) |
第一個字元必須是字母或數字。 沒有連續虛線或底線 |
idx-hotels-2024 |
| 欄位 | 1 -128 | 上限或下限 | 字母、數位、底線 (_) |
第一個字元必須是字母。 名稱開頭不能是 「azureSearch」。 |
Store_Name |
| 文件索引鍵 | 1024 | 上限或下限 | 字母、數位、虛線 (-) 、底線 (_) 、等號 = () 對於複合索引鍵，我們建議使用破折號、底線或等號做為分隔符號。 如果索引鍵包含其他符號，建議您使用Base64的URL安全變體進行編碼。 例如，在 .NET 中，您可以針對此目的使用 HttpServerUtility.UrlTokenEncode 方法。 |
第一個字元不能是底線。 | RXhhbXBsZSBkb2N1bWVudCBrZXk= 以基底 64 編碼的字串「範例檔金鑰」。 建議使用 URL 安全 Base64 編碼，因為文件金鑰有時會用於 URL 路徑中。 編碼可讓您在文件索引鍵中使用在 URL 中會有問題的字元。 |
| 評分設定檔 | 1 - 128 | 上限或下限 | 字母、數位、底線 (_) |
第一個字元必須是字母或數字。 | BoostFunc_TagsCustHist |
| 建議工具 | 1 - 128 | 上限或下限 | 字母、數位、底線 (_) |
第一個字元必須是字母或數字。 | Sugst01_Apparel |
| 資料來源 | 1 - 128 | 較低 | 字母、數位、連字元 (-) |
第一個和最後一個字元必須是字母或數字。 | docdbds-onlinecatalog-20240228 |
| 索引子 | 1 -128 | 較低 | 字母、數位、連字元 (-) |
第一個和最後一個字元必須是字母或數字。 | docbindxr-onlinecatalog-20240228 |
| 同義字對應 | 1 -128 | 較低 | 字母、數位、連字元 (-) |
第一個和最後一個字元必須是字母或數字。 | custom-synonyms-2024 |
| 技能 | 1 -128 | 較低 | 字母、數位、連字元 (-) |
第一個和最後一個字元必須是字母或數字。 | grok-myfiles-skillset-1 |