本页介绍了如何解决 Cloud Data Fusion Dataplex 通用目录资产谱系集成问题。
运行时错误
如需查找数据流水线的相关日志，请在 Cloud Data Fusion 网页界面中前往您的实例，然后依次点击系统管理>管理>元数据服务。
Data Lineage API 未启用或未授予角色
如果项目中未启用 Data Lineage API，或者未向 Cloud Data Fusion 服务账号授予 Data Lineage Events Producer 角色，则会出现以下问题：
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"]],["最后更新时间 (UTC)：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)."]]
