本頁面說明如何解決 Cloud Data Fusion Dataplex Universal Catalog 資產系譜整合問題。
執行階段錯誤
如要查看資料管道相關的記錄，請前往 Cloud Data Fusion 網頁介面中的執行個體，然後依序按一下「系統管理」>「管理」>「中繼資料服務」。
未啟用 Data Lineage API 或未授予角色
如果專案未啟用 Data Lineage API，或是 Cloud Data Fusion 服務帳戶未獲授予 Data Lineage 事件製作者角色，就會發生下列問題：
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.
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-09-04 (世界標準時間)。"],[[["\u003cp\u003eThis page provides solutions for resolving issues related to Cloud Data Fusion Dataplex asset lineage integrations.\u003c/p\u003e\n"],["\u003cp\u003eRuntime errors can be investigated through the Cloud Data Fusion web interface's Metadata Service logs.\u003c/p\u003e\n"],["\u003cp\u003eIssues arising from the Data Lineage API not being enabled or the service account lacking the necessary role can be fixed by enabling the API and granting the Data Lineage Events Producer role.\u003c/p\u003e\n"],["\u003cp\u003ePipelines running on Cloud Data Fusion versions above 6.8.0 may require upgrading to resolve lineage-related errors.\u003c/p\u003e\n"],["\u003cp\u003eA lack of messages in logs and missing lineage in Dataplex suggests that the pipeline may be using unsupported plugins, necessitating the use of plugins that support data lineage.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot Dataplex Universal Catalog asset lineage integrations\n\nThis page shows you how to resolve issues with Cloud Data Fusion\nDataplex Universal Catalog asset lineage integrations.\n\nRuntime errors\n--------------\n\nTo find relevant logs for your data pipelines, go to your instance in the\nCloud Data Fusion web interface and click **System Admin** \\\u003e\n**Management** \\\u003e **Metadata Service**.\n\n### The Data Lineage API isn't enabled or role isn't granted\n\nThe following issue occurs when the Data Lineage API hasn't been enabled in\nthe project or the Cloud Data Fusion service account hasn't been granted\nthe Data Lineage Events Producer role: \n\n Error calling the metadata consumer data-catalog-consumer:\n io.grpc.StatusRuntimeException: PERMISSION_DENIED: Data Lineage API has not been\n used in project \u003cproject_id\u003e before or it is disabled. Enable it by visiting\n https://console.developers.google.com/apis/api/datalineage.googleapis.com/overview?project=\u003cproject_id\u003e\n then retry. If you enabled this API recently, wait a few minutes for the action\n to propagate to our systems and retry.\n\nTo resolve this issue, enable the Data Lineage API and grant the Data\nLineage Events Producer role to the Cloud Data Fusion Service Agent. For\nmore information, see [View lineage in Dataplex Universal Catalog](/data-fusion/docs/how-to/view-lineage-in-dataplex#before_you_begin).\n\n### Pipeline runs in an unsupported Cloud Data Fusion version\n\nThe following issue occurs when the Cloud Data Fusion instance is upgraded\nto a version greater than 6.8.0, but the pipeline hasn't been upgraded: \n\n Error calling the metadata consumer data-catalog-consumer:\n java.lang.IllegalArgumentException: FQN for the asset is null.\n\nTo resolve this issue, [upgrade the pipeline](/data-fusion/docs/how-to/upgrading)\nto the latest version.\n\n### No messages in logs and no lineage in Dataplex Universal Catalog\n\nThe following issue occurs when one of the plugins used in the pipeline doesn't\nsupport lineage egress to Dataplex Universal Catalog:\n\nThere aren't error or success messages in the logs and there's no lineage in\nDataplex Universal Catalog.\n\nTo resolve this issue, your pipeline must contain only the\n[plugins that support data lineage in Dataplex Universal Catalog](/data-fusion/docs/how-to/view-lineage-in-dataplex#supported_plugins)."]]
