이 페이지에서는 Cloud Data Fusion Dataplex 애셋 계보 통합의 문제를 해결하는 방법을 보여줍니다.
런타임 오류
데이터 파이프라인과 관련된 로그를 찾으려면 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.
이 문제를 해결하려면 Data Lineage API를 사용 설정하고 Cloud Data Fusion 서비스 에이전트에 Data Lineage 이벤트 제작자 역할을 부여하세요. 자세한 내용은 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.
[[["이해하기 쉬움","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(UTC)"],[[["\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)."]]
