エラー メッセージ

このページでは、Dataproc Metastore の使用時に発生する可能性のある一般的なエラー メッセージについて説明します。各メッセージには、メッセージの意味と、推奨されるエラーの解決方法に関する説明が含まれています。

一般的なエラー:

  • 無効なクライアント入力:

    • 「ResourceName エラーパス [RESOURCE_NAME] がテンプレート [RESOURCE_TEMPLATE] と一致しません」
    • 「ウェアハウス ディレクトリのオーバーライドが無効です: [GCS_URI]」
    • 「提供された krb5.conf オブジェクト krb5Config が無効です。」

  • 無効な API リソースの状態:

    • 「リソース [RESOURCE_NAME] の現在の状態は、このオペレーションに有効な状態ではありません。有効な状態は [RESOURCE_STATE] です。」
    • Dataproc Metastore サービスで更新、インポート、エクスポート、バックアップ、復元を実行しようとしたが、サービスが ACTIVE ではありませんでした。
    • 「バックアップ [BACKUP_ID] は準備できていません。」

  • API アクセス権限:

    • Dataproc Metastore API を呼び出すために必要な権限がありませんでした。

  • サービス エージェントの権限が不十分です。

    • 「Dataproc Metastore サービス エージェント [SERVICE_AGENT] には、ネットワーク [NETWORK] にアクセスするための十分な IAM 権限がありません。サービス エージェントにプロジェクト [PROJECT_NUMBER] の roles/metastore.serviceAgent が付与されていることを確認してください。」

    • 「Dataproc Metastore サービス エージェントは、権限 [SERVICE_AGENT_PERMISSIONS] で Cloud Storage URI [GCS_URI] にアクセスできません。権限または VPC Service Controls サービス境界を確認してください。」

    • 「提供されているウェアハウス ディレクトリの Cloud Storage バケット [GCS_URI] は、Dataproc Metastore サービス エージェントによる読み取りおよび書き込みはできません。」

インポートとエクスポートに関するエラー:

バックアップと復元に関するエラー:

一般的なエラー

このセクションでは、一般的なエラーについて説明します。

無効なクライアント入力

これは一般的なエラーで、サーバーの状態とは関係なく、リクエストに関する何かが無効であることを意味します。このエラータイプは、次のようなさまざまな理由により発生する可能性があります。

  • REST API の使用時に、無効な形式でネットワークの名前を指定しました。

    ResourceName エラーのパス [RESOURCE_NAME] がテンプレート [RESOURCE_TEMPLATE] と一致しません。

  • ウェアハウス ディレクトリは有効な Cloud Storage パスではありません。詳細については、Hive Metastore をご覧ください。

    無効なウェアハウス ディレクトリのオーバーライド: [GCS_URI]。

  • 無効な Kerberos 構成を指定しました（サービスの Kerberos を構成するを参照）。

    提供された krb5.conf オブジェクト krb5Config が無効です。

推奨される対応策: リクエストを修正します。

無効な API リソースの状態:

これは一般的なエラーで、リクエストに関する何かが、サーバー リソースの現在の状態に適合していないことを意味します。

「リソース [RESOURCE_NAME] の現在の状態は、このオペレーションに有効な状態ではありません。有効な状態は [RESOURCE_STATE] です。

これは、例えば、API リソース（Dataproc Metastore サービス、インポート、エクスポート、バックアップ、復元）が、アクションを行う正しい状態でない場合に発生します。

  • Dataproc Metastore サービスで更新、インポート、エクスポート、バックアップ、復元を実行しようとしたが、サービスが ACTIVE ではありませんでした。

  • バックアップを復元しようとして、Dataproc Metastore サービスは ACTIVE でしたが、バックアップは ACTIVE ではありませんでした。

    バックアップ [BACKUP_ID] の準備ができていません。

推奨される対応策: リクエストを再試行する前に、API リソースが正しい状態であることを確認します。

API アクセス権限

Dataproc Metastore API を呼び出すために必要な権限がありませんでした。

推奨される対応: 適切な Dataproc Metastore IAM 権限をユーザーに付与します。

不十分なサービス エージェントの権限

プロジェクトでリソースを作成するときに、権限エラーが発生しました。このエラーは通常、削除されたサービス アカウントや変更されたサービス アカウントの権限などによって発生します。

  • 別のプロジェクトに属しているネットワークを使用しましたが、Dataproc Metastore サービス エージェントにアクセス権が付与されていません。詳細については、プロジェクト間のデプロイをご覧ください。

    Dataproc Metastore サービス エージェント [SERVICE_AGENT] には、ネットワーク [NETWORK] にアクセスするための十分な IAM 権限がありません。サービス エージェントにプロジェクト [PROJECT_NUMBER] の roles/metastore.serviceAgent が付与されていることを確認してください。

  • カスタム データ ウェアハウスの Cloud Storage バケットを提供しましたが、Dataproc Metastore サービス エージェントにアクセス権限を付与しませんでした。詳しくは、Hive ウェアハウス ディレクトリをご覧ください。

    Dataproc Metastore サービス エージェントは、権限 [SERVICE_AGENT_PERMISSIONS] で Cloud Storage URI [GCS_URI] にアクセスできません。権限または VPC Service Controls サービス境界を確認してください。

または、Dataproc Metastore が Cloud Storage パスのウェアハウス ディレクトリにアクセスできませんでした。

提供されているウェアハウス ディレクトリの Cloud Storage バケット [GCS_URI] は、Dataproc Metastore サービス エージェントによる読み取りおよび書き込みはできません。

推奨される対応策: サービス アカウントの権限または VPC Service Controls サービス境界を確認します。

インポートとエクスポートに関するエラー

このセクションでは、インポートとエクスポートに関連するエラーについて説明します。

Cloud Storage 権限のインポートとエクスポートを行う

Dataproc Metastore サービス エージェントに、インポートまたはエクスポートを行う十分な権限がありませんでした。

「Dataproc Metastore サービス エージェント」または「呼び出し元」には、Cloud Storage URI のインポート/エクスポートに必要な権限がありません（[SERVICE_AGENT] は権限 [SERVICE_AGENT_PERMISSIONS] を使用して Cloud Storage URI [GCS_URI] にアクセスできません])。

推奨される対応策: サービス アカウントの権限または VPC Service Controls サービス境界を確認します。

サポートされていない Hive バージョンで Avro のインポートまたはエクスポートが実行されている

Avro ファイルからのインポートは、Hive バージョン [HIVE_METASTORE_VERSION] ではサポートされていません。サポートされているバージョンは [SUPPORT_HIVE_VERSIONS] です。

推奨される対応策: 最新の Hive バージョンのサポートについては、バージョン ポリシーをご覧ください。データベース ファイルをサポートされているバージョンに更新します。

インポート テーブルが見つかりません

  • Avro インポートの場合

    テーブル [MISSING_TABLE_LIST] の Avro ソースファイルが見つかりません。

  • SQL インポートの場合

    Hive スキーマの検証で不合格となりました。テーブルがありません。[MISSING_TABLE_LIST]。

推奨される対応策: Dataproc Metastore Toolkit を参照して、データベース ファイルの Hive メタデータ スキーマを確認します。

バックアップと復元に関するエラー

このセクションでは、バックアップと復元に関連するエラーについて説明します。

復元対象のバックアップが見つかりません:

サービスのバックアップを復元すると、Dataproc Metastore では提供されたバックアップ リソースを見つけられませんでした。

バックアップ [BACKUP_ID] が見つかりません。

推奨される対応: バックアップが Dataproc Metastore サービス内にあることを確認します。

バックアップを削除できません

バックアップをサービスの復元に使用しているときに、バックアップを削除できませんでした。

[RESOURCE_STATE] 状態のバックアップは削除できません。

推奨される対応: 復元ジョブが完了するまで待ってから、バックアップを削除します。

次のステップ

  • Dataproc Metastore の使用時に発生する可能性のある一般的な問題の解決策については、トラブルシューティングをご覧ください。