叢集設定疑難排解

重要

AKS 上的 Azure HDInsight 於 2025 年 1 月 31 日淘汰。 透過此公告 深入瞭解。

您必須將工作負載移轉至 Microsoft Fabric 或對等 Azure 產品，以避免突然終止工作負載。

重要

這項功能目前為預覽狀態。 Microsoft Azure 預覽版的補充使用規定 包含適用於 Beta 版、預覽版或尚未正式發行之 Azure 功能的更合法條款。 如需此特定預覽的相關資訊，請參閱 AKS 上的 Azure HDInsight 預覽資訊。 如有問題或功能建議，請在 AskHDInsight 上提交請求，並關注我們以獲取 Azure HDInsight 社群 的更多更新。

不正確的叢集設定可能會導致部署錯誤。 一般而言，當 ARM 範本或 Azure 入口網站輸入中提供的設定不正確時，就會發生這些錯誤，例如在 [組態管理] 頁面上。

注意

這些錯誤的原因會以 "User." 作為前綴開始。

範例組態錯誤：

下表提供錯誤碼及其描述，以協助診斷和修正常見的錯誤。

設定錯誤

錯誤碼	描述
User.TrinoError	Trino 進程啟動失敗，並出現一般錯誤。 驗證 服務組態設定檔中的 Trino 特定組態檔。
User.Configuration.TrinoError	Trino 進程啟動失敗，並出現應用程式設定錯誤。 驗證 服務組態設定檔案中的 trino 特定組態檔。
使用者.設定.檔案被禁止	不允許變更某些三元組態檔。
使用者.配置.參數禁止	不允許變更某些三元組態參數。
使用者.設定.無效元件	指定的服務元件無效。 如需詳細資訊，請參閱 服務組態設定檔。
User.Configuration.MiscFile.無效名稱	無效的雜項檔名。 如需詳細資訊，請參閱 其他檔案。
使用者.設定.其他檔案.無效路徑	其他檔案路徑太長。
User.Configuration.MiscFile.NotFound	在其他檔案組態中，找到一個沒有對應檔案的MISC標籤。 如需詳細資訊，請參閱 其他檔案。
用戶配置.其他文件.重複名稱	其他檔案 設定區段中找到重複的檔名值。
User.Configuration.MiscFile.DuplicatePath	[其他檔案] 組態區段中找到重複的路徑值。
使用者.設定.格式錯誤	格式不正確的服務組態、錯誤區段中使用的內容/值屬性。 如需詳細資訊，請參閱 服務組態設定檔。
User.Configuration.HiveMetastore.多重密碼设置	catalogOptions.hive 目錄中指定的多個密碼。 指定 metastoreDbConnectionPasswordSecret 或 metastoreDbConnectionPassword 這兩個屬性的其中一個。
使用者.設定.HiveMetastore.需要密碼	catalogOptions.hive 目錄要求密碼。 指定 metastoreDbConnectionPasswordSecret 或 metastoreDbConnectionPassword 這兩個屬性的其中一個。
使用者.密碼.錯誤	Azure KeyVault 中設定錯誤的機密或權限。
使用者秘密.無效的金鑰庫URI	在 secretsProfile 中遺漏 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 物件。 確認物件的名稱、類型和版本。
使用者.插件.錯誤	儲存體帳戶中設定錯誤的外掛程式或許可權。
User.Plugins.DuplicateName（使用者插件重複名稱）	叢集組態 userPluginsSpec 中使用的重複外掛程式名稱。
User.Plugins.DuplicatePath	叢集組態 userPluginsSpec 中使用的重複外掛程式路徑。
使用者.插件.無效路徑	外掛程式的格式錯誤的存儲 URI。
User.Plugins.路徑未找到	在記憶體帳戶中找不到外掛程式的指定路徑。
User.Telemetry.InvalidStoragePath	userTelemetrySpec 中格式不正確的記憶體 URI。
User.Telemetry.HiveCatalogNotFound	在userTelemetrySpec中，將一個不存在的Hive資料庫指定為遙測數據表的目標。
User.CatalogOptions.HiveCatalogNotFound	在指定的 catalogOptions.hive 組態下，於 Trino 目錄中找不到 Hive 目錄 服務組態設定檔。 如需詳細資訊，請參閱 Hive 中繼存放區。

系統錯誤

某些錯誤可能會因為環境狀況而發生，而且是暫時性的。 這些錯誤的原因是因為以「System.」為開頭。 在這種情況下，請嘗試下列步驟：

1. 收集下列資訊：
   1. Azure 要求 CorrelationId。 您可以在 [通知] 區域中找到它;或位於叢集所在的資源群組底下，於 [部署] 頁面上;或在 az 命令輸出中。
   2. DeploymentId。 您可以在 [叢集概觀] 頁面中找到。
   3. 詳細的錯誤訊息。
2. 請連絡支援小組以取得這項資訊。

錯誤碼	描述
System.DependencyFailure	其中一個叢集元件失敗。