群集配置疑难解答
重要
AKS 上的 Azure HDInsight 已于 2025 年 1 月 31 日停用。 了解此公告的详细信息。
需要将工作负荷迁移到 Microsoft Fabric 或等效的 Azure 产品，以避免工作负荷突然终止。
重要
此功能目前以预览版提供。 Microsoft Azure 预览版的补充使用条款 包括适用于 Beta 版、预览版或尚未正式发布的 Azure 功能的更多相关法律条款。 有关此特定预览版的信息，请参阅 Azure HDInsight on AKS 预览版信息。 有关问题或功能建议，请在 AskHDInsight 上提交请求，并提供详细信息，并关注我们以便获取更多关于 Azure HDInsight 社区 的更新。
不正确的群集配置可能会导致部署错误。 通常，当 ARM 模板中提供的配置不正确或 Azure 门户中的输入（例如，在配置管理页上）时，会发生这些错误。
注意
这些错误的原因将以“User.”前缀开头。
示例配置错误：
下表提供错误代码及其说明来帮助诊断和修复常见错误。
配置错误
| 错误代码 | 描述 |
|---|---|
| User.TrinoError | Trino 进程启动失败，出现泛型错误。 验证 服务配置文件中 trino 特定的配置文件。 |
| 用户.配置.TrinoError | Trino 进程启动失败，并出现应用程序配置错误。 验证 服务配置概要文件中的trino特定配置文件。 |
| 用户配置文件禁止 | 不允许对某些 Trino 配置文件进行更改。 |
| 用户配置参数禁止 | 不允许对某些三元配置参数进行更改。 |
| 用户.配置.无效组件 | 指定的服务组件无效。 有关详细信息，请参阅 服务配置文件。 |
| User.Configuration.MiscFile.InvalidName | 杂项文件名称无效。 有关详细信息，请参阅 杂项文件。 |
| 用户.配置.杂项文件.路径无效 | 杂项文件路径太长。 |
| 用户配置文件未找到 | 在杂项文件配置中发现 MISC 标记，但没有相应的文件。 有关详细信息，请参阅 杂项文件。 |
| User.Configuration.MiscFile.DuplicateName | 杂项文件 配置部分找到重复的“fileName”值。 |
| 用户.配置.杂项文件.重复路径 | 杂项文件 配置节中路径值重复。 |
| 用户配置格式错误 | 格式不正确的服务配置、错误部分中使用的内容/值属性。 有关详细信息，请参阅 服务配置文件。 |
| 用户.配置.Hive元存储.多个密码 | catalogOptions.hive 目录中指定的多个密码。 指定 metastoreDbConnectionPasswordSecret 或 metastoreDbConnectionPassword 这两个属性中的一个。 |
| 用户.配置.HiveMetastore.需要密码 | 需要密码才能访问 catalogOptions.hive 目录。 指定 metastoreDbConnectionPasswordSecret 或 metastoreDbConnectionPassword 这两个属性中的一个。 |
| User.Secrets.Error | Azure KeyVault 中配置错误的机密或权限。 |
| 用户.机密.无效的密钥保管库URI | 机密配置文件中缺少 Azure Key Vault URI。 |
| User.Secrets.KeyVaultUriRequired | secretsProfile 中缺少 Azure Key Vault 的 URI。 |
| User.Secrets.DuplicateReferenceName | 在 secretsProfile 中发现重复的 referenceName。 |
| 用户.秘密.密钥库对象使用多次 | 同一密钥保管库对象/版本多次用作 secretsProfile 中机密列表中的不同引用。 |
| 用户.秘密.未指定 | 在 secretsProfile 中发现SECRET_REF标记中没有相应的机密对象。 |
| 用户.秘密.未找到 | KeyVault 中未找到 secretsProfile 中指定的 Key Vault 对象。 验证对象的名称、类型和版本。 |
| 用户.插件.错误 | 存储帐户中配置错误的插件或权限。 |
| 用户.插件.重复名称 | 群集配置 userPluginsSpec 中使用的插件名称重复。 |
| 用户.插件.重复路径 | 群集配置 userPluginsSpec 中使用的重复插件路径。 |
| User.Plugins.InvalidPath（用户.插件.无效路径） | 格式不正确的插件存储 URI。 |
| 用户.插件.路径未找到 | 在存储帐户中找不到插件的指定路径。 |
| 用户.遥测.无效存储路径 | userTelemetrySpec 中格式不正确的存储 URI。 |
| 用户.遥测.蜂巢目录未找到 | 在 userTelemetrySpec 中，指定了一个不存在的 Hive 目录作为遥测表的目标。 |
| 用户.目录选项.Hive目录未找到 | 在 Trino 目录集中找不到 Hive 目录，指定的 catalogOptions.hive 配置下的服务配置文件 ...。 有关详细信息，请参阅 Hive 元存储。 |
系统错误
某些错误可能是由于环境条件和暂时性的。 这些错误有理由以“System.”开头作为前缀。 在这种情况下，请尝试以下步骤：
- 收集以下信息：
- Azure 请求 CorrelationId。 可以在通知区域中找到它;或在群集所在的资源组下，在“部署”页上;或在 az 命令输出中。
- DeploymentId。 可以在“群集概述”页中找到它。
- 详细的错误消息。
- 请与支持团队联系以获取此信息。
| 错误代码 | 描述 |
|---|---|
| System.DependencyFailure (系统依赖失败) | 群集组件之一中的故障。 |