你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
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= 以 base 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 |