Résoudre les problèmes de lignée de données

Ce document vous aide à résoudre les problèmes les plus courants liés à l'absence de graphiques de lignée des données dans Knowledge Catalog (anciennement Dataplex Universal Catalog). Résoudre ces problèmes vous permet de suivre correctement le déplacement des données, de comprendre leur origine et de déboguer les pipelines de données.

Types de projets

Les composants de données peuvent résider dans différents projets. Vous trouverez ci-dessous un récapitulatif des projets possibles et de leurs noms d'éléments.

Projet de stockage BigQuery

Ce projet stocke vos composants de données BigQuery. Vous le trouverez dans les détails de l'élément, dans Table ID, avant le premier point.

Dans l'UI BigQuery, le nom du projet de stockage est indiqué dans le champ "ID de la table", avant le premier point du nom complet de la table.
Figure 1. Nom d'un projet de stockage BigQuery.

Projet Compute

Ce projet stocke les métadonnées de traçabilité des données. Pour BigQuery, c'est là que vous exécutez un job. Si vous exécutez un job à l'aide de la console Google Cloud , vous pouvez trouver le nom du projet de calcul dans le sélecteur de projet :

L'UI BigQuery affiche un projet de calcul appelé "docs-compute" sur la page où vous exécutez des requêtes SQL.
Figure 2. Nom d'un projet de calcul qui exécute des jobs BigQuery.

Lorsque vous envoyez des requêtes à l'API BigQuery, spécifiez le projet de calcul dans l'URL, par exemple :

POST /bigquery/v2/projects/docs-compute/jobs HTTP/1.1
Host: bigquery.googleapis.com
User-Agent: Go-http-client/1.1
Authorization: <REDACTED 1031 BYTES>
Accept-Encoding: gzip
{
  "configuration": {
    "query": {
      "useLegacySql": false,
      "query": "CREATE OR REPLACE TABLE `docs-target.dataset.target-002` AS SELECT * FROM `docs-source.dataset.source-002`;"
    }
  },
  "jobReference": {
    "projectId": "docs-compute",
    "jobId": "docs-compute-job-id",
    "location": "us",
  }
}

Projet actif

Il s'agit du projet à partir duquel vous consultez la traçabilité des données. La console Google Cloud affiche le projet actif dans le sélecteur de projets. Si vous utilisez l'API, le projet actif est celui à partir duquel vous effectuez des appels d'API.

L'UI BigQuery affiche la provenance des données pour un ensemble de données appelé &quot;source-001&quot;, qui se trouve dans un projet appelé &quot;docs-source&quot;.
Figure 3 : Projet actif dans la console Google Cloud .

La traçabilité des données BigQuery ne s'affiche pas

Le problème suivant se produit après l'exécution d'un job BigQuery. Dans ce cas, le problème peut être dû à trois scénarios :

Si le message "Échec de l'extraction de la traçabilité en raison d'autorisations manquantes" s'affiche, cela signifie que vous ne disposez pas des autorisations nécessaires pour le projet actif. Sinon, vous ne disposez pas des autorisations nécessaires pour le projet de calcul.

Graphique de traçabilité vide.
Figure 4 : Exemple de traçabilité qui ne s'affiche pas dans l'UI BigQuery.

Pour résoudre ce problème, vérifiez si l'API Data Lineage est activée pour le projet de calcul. Une fois l'API activée, vous devez exécuter un job pour afficher la traçabilité des données. Selon le volume et la complexité des données traitées, l'affichage de la traçabilité des données peut prendre de 30 minutes à 24 heures.

Ensuite, vérifiez si l'API Data Lineage est activée pour le projet actif.

Lorsque l'API Data Lineage est activée, accordez le rôle Lecteur de la traçabilité des données (roles/datalineage.viewer) dans les projets actifs et Compute.

Les métadonnées du processus BigQuery ne s'affichent pas

Le problème suivant se produit lorsque vous ouvrez le volet d'informations sur la table, qui n'affiche pas tous les détails tels que l'instruction SQL ou la propriété Process type. Cela se produit même si la traçabilité des données s'affiche correctement.

Cela peut se produire lorsque vous n'êtes pas autorisé à afficher les métadonnées dans le projet de calcul.

Exemple :

Si vous cliquez sur les détails du processus BigQuery, le message suivant s'affiche dans la console Google Cloud  :

You don't have permission to view BigQuery process metadata in project X.
Dans l'UI BigQuery, dans l'onglet &quot;Traçabilité&quot;, le volet &quot;Détails&quot; affiche un message d'erreur.
Figure 5. Exemple de détails de processus BigQuery qui ne s'affichent pas dans l'UI BigQuery.

Pour résoudre ce problème, accordez à l'utilisateur l'autorisation bigquery.jobs.get (par exemple, incluse dans le rôle Lecteur de ressources BigQuery) dans le projet de calcul.

Les détails de la table BigQuery ne s'affichent pas

Le problème suivant se produit lorsque vous ouvrez le volet d'informations sur la table, qui n'affiche que la propriété Fully qualified name. Cela se produit même si la lignée de données s'affiche correctement. Cela peut se produire lorsque vous ne disposez pas de toutes les autorisations requises dans les projets de stockage de la table.

Exemple :

Dans ce cas, lorsque vous cliquez sur les détails du nœud BigQuery, le message Entry with this fully qualified name is not available in Knowledge Catalog or you do not have permissions to view it s'affiche.

Les détails de la table BigQuery ne s'affichent pas.
Figure 6 : Exemple de détails de table BigQuery qui ne s'affichent pas dans l'UI BigQuery.

Pour résoudre ce problème, accordez l'autorisation bigquery.tables.get (par exemple, incluse dans le rôle Lecteur de données BigQuery) dans le projet de stockage.

Frais inattendus pour le traitement Premium de Knowledge Catalog

Vous avez désactivé l'API Dataplex (dataplex.googleapis.com) pour arrêter les frais, mais vous continuez à voir des frais quotidiens pour le SKU "Traitement premium Knowledge Catalog".

Ce problème peut se produire si l'API Data Lineage (datalineage.googleapis.com) reste activée. L'API Data Lineage est facturée sous le SKU "Traitement premium Knowledge Catalog", mais elle est gérée en tant qu'API distincte dans la console Google Cloud . La désactivation de l'API Dataplex ne désactive pas l'API Data Lineage ni n'arrête sa facturation.

Pour déterminer si la traçabilité des données est à l'origine des frais, recherchez le libellé goog-dataplex-workload-type avec la valeur LINEAGE dans votre rapport Cloud Billing.

Pour éviter ces frais, désactivez la traçabilité des données en désactivant l'API Data Lineage dans vos projets.