你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

命名规则 (Azure AI 搜索)

本部分介绍 Azure AI 搜索的命名规则。

命名规则图表

约定因对象的使用方式而异。 其他标准的命名规则强加于特定的 Azure AI 搜索对象。 URL 和 JSON 在区分大小写、特殊字符和字符放置方面有不同的约定。 根据必要,URL(主机名、路径或查询字符串)或 JSON 请求正文中引用的对象必须遵循适用标准的命名约定。

Name 长度 案例 允许的字符 角色放置 Example
服务 2 - 60 Lower 字母、数字、破折号 (- 第一个、第二个和最后一个字符必须是字母或数字。

任何地方都没有连续的破折号。
contoso-srch1
Index 2 - 128 Lower 字母、数字、破折号 (-)、下划线 (_ 第一个字符必须是字母或数字。

没有连续的破折号或下划线
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 Lower 字母、数字、破折号 (- 第一个和最后一个字符必须是字母或数字。 docdbds-online目录-20240228
Indexer 1 -128 Lower 字母、数字、破折号 (- 第一个和最后一个字符必须是字母或数字。 文档bindxr-在线目录-20240228
同义词图 1 -128 Lower 字母、数字、破折号 (- 第一个和最后一个字符必须是字母或数字。 自定义同义词-2024
技能集 1 -128 Lower 字母、数字、破折号 (- 第一个和最后一个字符必须是字母或数字。 grok-myfiles-技能集-1

另请参阅