トラブルシューティング: Dataplex アセット リネージの統合

このページでは、Cloud Data Fusion の Dataplex アセット リネージの統合に関する問題を解決する方法について説明します。

ランタイム エラー

データ パイプラインに関連するログを見つけるには、Cloud Data Fusion ウェブ インターフェースでインスタンスに移動して、システム管理者 > 管理 > メタデータ サービス をクリックします。

Data Lineage API が有効になっていないか、ロールが付与されていない

プロジェクトで Data Lineage API が有効になっていないか、Cloud Data Fusion サービス アカウントにデータリネージ イベント プロデューサーのロールが付与されていない場合に、次の問題が発生します。

Error calling the metadata consumer data-catalog-consumer:
io.grpc.StatusRuntimeException: PERMISSION_DENIED: Data Lineage API has not been
used in project <project_id> before or it is disabled. Enable it by visiting
https://console.developers.google.com/apis/api/datalineage.googleapis.com/overview?project=<project_id>
then retry. If you enabled this API recently, wait a few minutes for the action
to propagate to our systems and retry.

この問題を解決するには、Data Lineage API を有効にして、データリネージ イベント プロデューサーのロールを Cloud Data Fusion サービス エージェントに付与します。詳細については、Dataplex でリネージを表示するをご覧ください。

サポートされていない Cloud Data Fusion バージョンでパイプラインが実行されている

Cloud Data Fusion インスタンスを 6.8.0 より後のバージョンにアップグレードしているが、パイプラインがアップグレードされていない場合、次の問題が発生します。

Error calling the metadata consumer data-catalog-consumer:
java.lang.IllegalArgumentException: FQN for the asset is null.

この問題を解決するには、パイプラインを最新バージョンにアップグレードします。

ログにメッセージがなく、Dataplex にリネージがない

パイプラインで使用されているプラグインの 1 つが Dataplex への下りのリネージをサポートしていない場合に、次の問題が発生します。

ログにエラーや成功メッセージがなく、Dataplex にリネージがありません。

この問題を解決するには、パイプラインに Dataplex でデータリネージをサポートするプラグインのみを含める必要があります。