Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment résoudre les problèmes liés à Cloud Data Fusion.
Récupérer des informations d'erreur pour une exécution de pipeline ayant échoué
Lorsqu'une exécution de pipeline échoue, vous pouvez récupérer des informations détaillées sur l'erreur.
Cloud Data Fusion 6.11.0 classe les erreurs de pipeline par catégorie, raison et message. Cette classification accélère la résolution et réduit le besoin d'examiner des journaux complexes.
Pour obtenir des informations détaillées sur l'erreur, procédez comme suit:
Console
Dans la console Google Cloud , ouvrez votre instance Cloud Data Fusion, puis accédez à votre pipeline sur la page Studio.
Sur le nœud où l'erreur s'est produite, cliquez sur Afficher les erreurs.
Examinez les détails de l'erreur, y compris la catégorie, la raison et le message d'erreur.
Facultatif: Pour télécharger les journaux bruts à des fins d'analyse, cliquez sur Télécharger les journaux bruts.
Facultatif: Pour afficher les journaux bruts, cliquez sur Afficher les journaux.
REST
Envoyez une requête POST au point de terminaison suivant:
Voici un exemple de réponse en cas d'erreur de plug-in:
[
{
"stageName": "Stage Name",
"errorCategory": "Plugin-x",
"errorReason": "Input path gs://x does not exist",
"errorMessage": "Input path gs://x does not exist",
"errorType": "SYSTEM/USER/UNKNOWN",
"dependency": "true/false"
}
]
```
You can also [view advanced logs for your pipelines](/data-fusion/docs/how-to/viewing-stackdriver-logs).
Résoudre les problèmes liés à la création d'une instance Cloud Data Fusion
Lorsque vous créez une instance Cloud Data Fusion, vous pouvez rencontrer le problème suivant:
Read access to project PROJECT_ID was denied.
Pour résoudre ce problème, désactivez et réactivez l'API Cloud Data Fusion, puis créez l'instance.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThis page provides guidance on resolving issues within Cloud Data Fusion, specifically focusing on retrieving error information for failed pipeline runs and addressing instance creation problems.\u003c/p\u003e\n"],["\u003cp\u003eWhen a pipeline run fails, you can access detailed error information through the Cloud Data Fusion console by navigating to the pipeline in the Studio and clicking "View errors" on the relevant node, which then displays categorized error details.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve error details programmatically for failed pipeline runs using a REST API \u003ccode\u003ePOST\u003c/code\u003e request, which categorizes errors into \u003ccode\u003eerrorCategory\u003c/code\u003e, \u003ccode\u003eerrorReason\u003c/code\u003e, and \u003ccode\u003eerrorMessage\u003c/code\u003e properties.\u003c/p\u003e\n"],["\u003cp\u003eIf you encounter a "Read access to project" error when creating a Cloud Data Fusion instance, the solution is to disable and then re-enable the Cloud Data Fusion API before attempting to create the instance again.\u003c/p\u003e\n"]]],[],null,["# Troubleshoot Cloud Data Fusion\n\nThis page shows you how to resolve issues with Cloud Data Fusion.\n\nRetrieve error information for a failed pipeline run\n----------------------------------------------------\n\nWhen a pipeline run fails, you can retrieve detailed error information.\nCloud Data Fusion 6.11.0 classifies pipeline errors by category,\nreason, and message. This classification speeds up resolution and reduces the\nneed to examine complex logs.\n\nTo get error details, follow these steps: \n\n### Console\n\n1. In the Google Cloud console, open your Cloud Data Fusion\n instance and go to your pipeline on the **Studio** page.\n\n2. On the node where the error occurred, click **View errors**.\n\n3. Review the error details, which include the error category, error reason,\n and error message.\n\n4. Optional: To download raw logs for further analysis, click\n **Download raw logs**.\n\n5. Optional: To view raw logs, click **View logs**.\n\n### REST\n\nSend a `POST` request to the following endpoint: \n\n curl -H \"Authorization: Bearer $(gcloud auth print-access-token)\"\n -H \"Content-Type: application/json\" \n ${CDAP_ENDPOINT}/v3/namespaces/\u003cvar translate=\"no\"\u003eNAMESPACE_ID\u003c/var\u003e/apps/\u003cvar translate=\"no\"\u003ePIPELINE_NAME\u003c/var\u003e/workflows/DataPipelineWorkflow/runs/\u003cvar translate=\"no\"\u003eRUN_ID\u003c/var\u003e/classify -X POST\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eNAMESPACE_ID\u003c/var\u003e: the ID of the namespace\n- \u003cvar translate=\"no\"\u003ePIPELINE_NAME\u003c/var\u003e: the name of the pipeline\n- \u003cvar translate=\"no\"\u003eRUN_ID\u003c/var\u003e: the run ID of the pipeline\n\nThe following is a sample response for a plugin error: \n\n [\n {\n \"stageName\": \"Stage Name\",\n \"errorCategory\": \"Plugin-x\",\n \"errorReason\": \"Input path gs://x does not exist\",\n \"errorMessage\": \"Input path gs://x does not exist\",\n \"errorType\": \"SYSTEM/USER/UNKNOWN\",\n \"dependency\": \"true/false\"\n }\n ]\n ```\n You can also [view advanced logs for your pipelines](/data-fusion/docs/how-to/viewing-stackdriver-logs).\n\nResolve issues with creating Cloud Data Fusion instance\n-------------------------------------------------------\n\nWhen you create a Cloud Data Fusion instance, you might encounter the\nfollowing issue: \n\n Read access to project \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e was denied.\n\nTo resolve this issue, disable and re-enable the\n[Cloud Data Fusion API](/data-fusion/docs/how-to/enable-service), and\nthen create the instance."]]
