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

重要

此功能目前為預覽功能。 適用於 Microsoft Azure 預覽版的補充使用規定包含適用於 Beta 版、預覽版或尚未發行至正式運作之 Azure 功能的更合法條款。 如需此特定預覽的相關信息，請參閱 AKS 預覽資訊的 Azure HDInsight。 如需問題或功能建議，請在 AskHDInsight 上提交要求，並提供詳細數據，並遵循我們在 Azure HDInsight 社群上取得更多更新。

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

注意

這些錯誤會從 「User.」 前置詞開始有原因。

範例組態錯誤：

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

組態錯誤

錯誤碼	描述
User.TrinoError	Trino 進程啟動失敗，並出現一般錯誤。 確認服務組態配置檔中的 三個特定組態檔。
User.Configuration.TrinoError	Trino 進程啟動失敗，並出現應用程式設定錯誤。 確認服務組態配置檔中的 三個特定組態檔。
User.Configuration.FileForbidden	不允許變更某些三元組態檔。
User.Configuration.ParameterForbidden	不允許變更某些三元組態參數。
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 目錄中指定的多個密碼。 指定 metastoreDb 連線 ionPasswordSecret 或 metastoreDb 連線 ionPassword 這兩個屬性的其中一個。
User.Configuration.HiveMetastore.PasswordRequired	catalogOptions.hive 目錄所需的密碼。 指定 metastoreDb 連線 ionPasswordSecret 或 metastoreDb 連線 ionPassword 這兩個屬性的其中一個。
User.Secrets.Error	Azure KeyVault 中設定錯誤的秘密或許可權。
User.Secrets.InvalidKeyVaultUri	遺失 secretsProfile 中的 Azure 金鑰保存庫 URI。
User.Secrets.KeyVaultUriRequired	遺失 secretsProfile 中的 Azure 金鑰保存庫 URI。
User.Secrets.DuplicateReferenceName	secretsProfile 中找到重複的 referenceName。
User.Secrets.KeyVaultObjectUsedMultipleTimes	相同金鑰保存庫物件/版本多次作為 secretsProfile 中秘密清單中的不同參考。
User.Secrets.NotSpecified	在 secretsProfile 中，找到沒有對應秘密對象的標記SECRET_REF標籤標。
User.Secrets.NotFound	KeyVault 中找不到 secretsProfile 中指定的 金鑰保存庫 物件。 確認物件的名稱、類型和版本。
User.Plugins.Error	儲存體帳戶中設定錯誤的外掛程式或許可權。
User.Plugins.DuplicateName	叢集組態 userPluginsSpec 中使用的重複外掛程式名稱。
User.Plugins.DuplicatePath	叢集組態 userPluginsSpec 中使用的重複外掛程式路徑。
User.Plugins.InvalidPath	外掛程式的格式不正確的記憶體 URI。
User.Plugins.PathNotFound	在記憶體帳戶中找不到外掛程式的指定路徑。
User.Telemetry.Invalid 儲存體 Path	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	其中一個叢集元件失敗。