クラスター構成のトラブルシューティング
Note
Azure HDInsight on AKS は 2025 年 1 月 31 日に廃止されます。 2025 年 1 月 31 日より前に、ワークロードを Microsoft Fabric または同等の Azure 製品に移行することで、ワークロードの突然の終了を回避する必要があります。 サブスクリプション上に残っているクラスターは停止され、ホストから削除されます。
重要
現在、この機能はプレビュー段階にあります。 ベータ版、プレビュー版、または一般提供としてまだリリースされていない Azure の機能に適用されるその他の法律条項については、「Microsoft Azure プレビューの追加の使用条件」に記載されています。 この特定のプレビューについては、「Microsoft HDInsight on AKS のプレビュー情報」を参照してください。 質問や機能の提案については、詳細を記載した要求を AskHDInsight で送信してください。また、その他の更新情報については、Azure HDInsight コミュニティのフォローをお願いいたします。
クラスターの構成が正しくないと、デプロイ エラーが発生する可能性があります。 通常、これらのエラーは、ARM テンプレートで指定した構成または Azure portal (たとえば、[構成管理] ページ) での入力が間違っている場合に発生します。
Note
これらのエラーの原因の先頭には、"User." プレフィックスが付けられます。
構成エラーの例:
次の表に、一般的なエラーの診断と修正に役立つように、エラー コードとその説明を示します。
構成エラー
| エラー コード | 説明 |
|---|---|
| User.TrinoError | Trino プロセスの起動が一般的なエラーで失敗しました。 サービス構成プロファイルで trino 固有の構成ファイルを確認します。 |
| User.Configuration.TrinoError | Trino プロセスの起動がアプリケーション構成エラーで失敗しました。 サービス構成プロファイルで 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 | [その他のファイル] 構成セクションで、重複する path 値が見つかりました。 |
| User.Configuration.FormatError | 形式に誤りがあるサービス構成。コンテンツ/値のプロパティが間違ったセクションで使用されています。 詳細については、サービス構成プロファイルに関するページを参照してください。 |
| User.Configuration.HiveMetastore.MultiplePasswords | catalogOptions.hive カタログで、複数のパスワードが指定されています。 metastoreDbConnectionPasswordSecret または metastoreDbConnectionPassword の 2 つのプロパティのいずれかを指定します。 |
| User.Configuration.HiveMetastore.PasswordRequired | catalogOptions.hive カタログには、パスワードが必要です。 metastoreDbConnectionPasswordSecret または metastoreDbConnectionPassword の 2 つのプロパティのいずれかを指定します。 |
| 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 のシークレット一覧内の異なる参照として、同じ Key Vault オブジェクト/バージョンが複数回使用されました。 |
| 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." が付けられます。 このような場合は、次の手順を試してみてください。
- 次の情報を収集します。
- Azure 要求 CorrelationId。 これが表示されるのは、[通知] 領域内か、[デプロイ] ページ上でクラスターが配置されている [リソース グループ] の下か、あるいは az コマンド出力内のいずれかです。
- DeploymentId。 これは、[クラスターの概要] ページにあります。
- 詳細なエラー メッセージです。
- この情報をサポート チームに連絡してください。
| エラー コード | 説明 |
|---|---|
| System.DependencyFailure | クラスター コンポーネントの 1 つでエラーが発生しました。 |