Risolvere i problemi di integrazione della derivazione delle risorse del Catalogo universale Dataplex
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina mostra come risolvere i problemi relativi alle integrazioni della derivazione degli asset di Cloud Data Fusion con Dataplex Universal Catalog.
Errori di runtime
Per trovare i log pertinenti per le pipeline di dati, vai alla tua istanza nell'interfaccia web di Cloud Data Fusion e fai clic su Amministrazione sistema>Gestione>Servizio metadati.
L'API Data Lineage non è abilitata o il ruolo non è concesso
Il seguente problema si verifica quando l'API Data Lineage non è stata abilitata nel progetto o all'account di servizio Cloud Data Fusion non è stato concesso il ruolo 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.
Per risolvere il problema, attiva l'API Data Lineage e concedi il ruolo Data Lineage Events Producer all'agente di servizio Cloud Data Fusion. Per maggiori informazioni, consulta Visualizzare la derivazione nel Catalogo universale Dataplex.
La pipeline viene eseguita in una versione di Cloud Data Fusion non supportata
Il seguente problema si verifica quando viene eseguito l'upgrade dell'istanza Cloud Data Fusion
a una versione successiva a 6.8.0, ma non è stato eseguito l'upgrade della pipeline:
Error calling the metadata consumer data-catalog-consumer:
java.lang.IllegalArgumentException: FQN for the asset is null.
Nessun messaggio nei log e nessuna derivazione nel Catalogo universale Dataplex
Il seguente problema si verifica quando uno dei plug-in utilizzati nella pipeline non supporta l'esportazione della cronologia nel Catalogo universale Dataplex:
Nei log non sono presenti messaggi di errore o di successo e non è presente alcuna evoluzione nel Catalogo universale Dataplex.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)."]]
