針對叢集設定進行疑難排解

注意

AKS 上的 Azure HDInsight 將於 2025 年 1 月 31 日退場。 請於 2025 年 1 月 31 日之前，將工作負載移轉至 Microsoft Fabric 或對等的 Azure 產品，以免工作負載突然終止。 訂用帳戶中剩餘的叢集將會停止，並會從主機移除。

在淘汰日期之前，只有基本支援可用。

重要

此功能目前為預覽功能。 Microsoft Azure 預覽版增補使用規定包含適用於 Azure 功能 (搶鮮版 (Beta)、預覽版，或尚未正式發行的版本) 的更多法律條款。 若需此特定預覽版的相關資訊，請參閱 Azure HDInsight on AKS 預覽版資訊。 如有問題或功能建議，請在 AskHDInsight 上提交要求並附上詳細資料，並且在 Azure HDInsight 社群上追蹤我們以獲得更多更新資訊。

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

注意

這些錯誤的原因會以 "User." 開頭。

範例設定錯誤：

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

組態錯誤

錯誤碼	描述
User.TrinoError	Trino 程序啟動失敗，並出現一般錯誤。 請確認服務組態設定檔中的三個特定組態檔。
User.Configuration.TrinoError	Trino 程序啟動失敗，並出現應用程式設定錯誤。 請確認服務組態設定檔中的三個特定組態檔。
User.Configuration.FileForbidden	不允許變更某些 trino 組態檔。
User.Configuration.ParameterForbidden	不允許變更某些 trino 組態參數。
User.Configuration.InvalidComponent	指定的服務元件無效。 如需詳細資訊，請參閱服務組態設定檔。
User.Configuration.MiscFile.InvalidName	其他 fileName 無效。 如需詳細資訊，請參閱其他檔案。
User.Configuration.MiscFile.InvalidPath	其他檔案路徑太長。
User.Configuration.MiscFile.NotFound	在其他檔案組態中，找到沒有對應檔案的 MISC 標籤。 如需詳細資訊，請參閱其他檔案。
User.Configuration.MiscFile.DuplicateName	在 [其他檔案] 組態區段中找到重複的 fileName 值。
User.Configuration.MiscFile.DuplicatePath	在 [其他檔案] 組態區段中找到重複的路徑值。
User.Configuration.FormatError	服務組態格式不正確、內容/值屬性用於錯誤區段。 如需詳細資訊，請參閱服務組態設定檔。
User.Configuration.HiveMetastore.MultiplePasswords	catalogOptions.hive 目錄中指定了多個密碼。 請指定metastoreDbConnectionPasswordSecret 或 metastoreDbConnectionPassword 這兩個屬性的其中一個。
User.Configuration.HiveMetastore.PasswordRequired	catalogOptions.hive 目錄需要密碼。 請指定metastoreDbConnectionPasswordSecret 或 metastoreDbConnectionPassword 這兩個屬性的其中一個。
User.Secrets.Error	Azure KeyVault 中的祕密或權限設定錯誤。
User.Secrets.InvalidKeyVaultUri	secretsProfile 中遺漏 Azure Key Vault URI。
User.Secrets.KeyVaultUriRequired	secretsProfile 中遺漏 Azure Key Vault URI。
User.Secrets.DuplicateReferenceName	在 secretsProfile 中找到重複的 referenceName。
User.Secrets.KeyVaultObjectUsedMultipleTimes	相同金鑰保存庫物件/版本多次用來作為 secretsProfile 中祕密清單中的不同參考。
User.Secrets.NotSpecified	在 secretsProfile 中找到沒有對應祕密物件的 SECRET_REF 標籤。
User.Secrets.NotFound	KeyVault 中找不到 secretsProfile 中指定的 Key Vault 物件。 請確認物件的名稱、類型和版本。
User.Plugins.Error	儲存體帳戶中的外掛程式或權限設定錯誤。
User.Plugins.DuplicateName	叢集組態 userPluginsSpec 中使用重複的外掛程式名稱。
User.Plugins.DuplicatePath	叢集組態 userPluginsSpec 中使用重複的外掛程式路徑。
User.Plugins.InvalidPath	外掛程式的儲存體 URI 格式不正確。
User.Plugins.PathNotFound	在儲存體帳戶中找不到外掛程式的指定路徑。
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	其中一個叢集元件失敗。