本節說明 Azure AI 搜尋服務的命名規則。
命名規則圖表
慣例因物件的使用方式而異。 其他標準的命名規則會強制施加在特定的 Azure AI 搜尋服務物件上。 URL 和 JSON 在區分大小寫、特殊字元和字元放置方面有不同的慣例。 必要情況下，URL （主機名稱、路徑或查詢字串） 或 JSON 要求內文中參照的物件必須遵循適用標準的命名慣例。
| 名稱 | 長度 | 案例 | 允許的字元 | 角色放置 | Example |
|---|---|---|---|---|---|
| 服務 | 2 - 60 | 較低 | 字母、數字、破折號 （-） |
第一個、第二個和最後一個字元必須是字母或數字。 任何地方都沒有連續的衝刺。 |
contoso-srch1 |
| Index | 2 - 128 | 較低 | 字母、數字、破折號 （-）、底線 （_） |
第一個字元必須是字母或數字。 沒有連續的破折號或底線 |
IDX 酒店-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-online目錄-20240228 |
| Indexer | 1 -128 | 較低 | 字母、數字、破折號 （-） |
第一個和最後一個字元必須是字母或數字。 | docbindxr-online目錄-20240228 |
| 同義詞地圖 | 1 -128 | 較低 | 字母、數字、破折號 （-） |
第一個和最後一個字元必須是字母或數字。 | 自訂同義詞-2024 |
| 技能 | 1 -128 | 較低 | 字母、數字、破折號 （-） |
第一個和最後一個字元必須是字母或數字。 | grok-myfiles-技能集-1 |