In diesem Dokument wird beschrieben, wie Sie Probleme mit der Dataplex-Datenabstammung beheben.
Projekttypen
Daten-Assets können sich in verschiedenen Projekten befinden. Im Folgenden findest du eine Zusammenfassung möglicher Projekte und ihrer Asset-Namen.
BigQuery-Speicherprojekt
In diesem Projekt werden Ihre BigQuery-Daten-Assets gespeichert.
Sie finden sie in den Asset-Details als Teil von Table ID
vor dem ersten Punkt.

Compute-Projekt
In diesem Projekt werden die Data-Lineage-Metadaten gespeichert. Bei BigQuery wird hier ein Job ausgeführt. Wenn Sie einen Job über die Google Cloud Console ausführen, finden Sie den Namen des Compute-Projekts in der Projektauswahl:

Geben Sie beim Senden von Anfragen an die BigQuery API das Compute-Projekt in der URL an, z. B.:
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",
}
}
Aktives Projekt
Das ist das Projekt, in dem Sie die Datenherkunft aufrufen. In der Google Cloud Console wird das aktive Projekt in der Projektauswahl angezeigt. Wenn Sie die API verwenden, ist das aktive Projekt das Projekt, über das Sie API-Aufrufe ausführen.

BigQuery-Datenabstammung wird nicht angezeigt
Nach dem Ausführen eines BigQuery-Jobs tritt das folgende Problem auf. In diesem Fall kann das Problem drei Ursachen haben:
- Die Data Lineage API ist im aktiven Projekt oder im Compute-Projekt deaktiviert.
- Sie haben nicht die Rolle Data Lineage Viewer (
roles/datalineage.viewer
) im Projekt active oder compute. - Die Datenabfolge ist noch nicht eingegangen. Je nach Umfang und Komplexität der verarbeiteten Daten kann es 30 Minuten bis 24 Stunden dauern, bis die Datenabfolge angezeigt wird.
Wenn unten auf der Seite die Meldung „Herkunft konnte aufgrund fehlender Berechtigungen nicht abgerufen werden“ angezeigt wird, fehlen Ihnen Berechtigungen für das aktive Projekt. Andernfalls fehlen Ihnen Berechtigungen für das Compute-Projekt.

Prüfen Sie zur Behebung dieses Problems, ob die Data Lineage API für das Compute-Projekt aktiviert ist. Nachdem Sie die API aktiviert haben, müssen Sie einen Job ausführen, um die Datenherkunft zu sehen. Je nach Umfang und Komplexität der verarbeiteten Daten kann es 30 Minuten bis 24 Stunden dauern, bis die Datenabfolge angezeigt wird.
Prüfen Sie als Nächstes, ob die Data Lineage API für das aktive Projekt aktiviert ist.
Wenn die Data Lineage API aktiviert ist, gewähren Sie die Rolle Data Lineage Viewer (roles/datalineage.viewer
) sowohl im aktiven als auch im Compute-Projekt.
BigQuery-Prozessmetadaten werden nicht angezeigt
Das folgende Problem tritt auf, wenn Sie den Detailbereich der Tabelle öffnen, in dem nicht alle Details wie die SQL-Anweisung oder die Process type
-Property angezeigt werden.
Das passiert, obwohl die Datenabfolge korrekt angezeigt wird.
Das kann passieren, wenn Sie nicht berechtigt sind, Metadaten im Compute-Projekt aufzurufen.
Beispiel:
- BigQuery-Quelltabelle:
docs-source.dataset.source-001
- BigQuery-Zieltabelle:
docs-target.dataset.target-001
- Datenabfolge zwischen
docs-source.dataset.source-001
unddocs-target.dataset.target-001
im Berechnungsprojektdocs-compute
- Sie haben die Rolle Data Lineage-Betrachter für
docs-compute
-Projekte, die sich im aktiven und Compute-Status befinden.
Wenn Sie auf die BigQuery-Prozessdetails klicken, wird in der Google Cloud Console die folgende Meldung angezeigt:
You don't have permission to view BigQuery process metadata in project X.

Um dieses Problem zu beheben, gewähren Sie dem Nutzer die Berechtigung bigquery.jobs.get
(z. B. in der Rolle BigQuery-Ressourcenbetrachter enthalten) im Compute-Projekt.
BigQuery-Tabellendetails werden nicht angezeigt
Das folgende Problem tritt auf, wenn Sie den Detailbereich der Tabelle öffnen, in dem nur die Property Fully qualified name
angezeigt wird. Das passiert, obwohl die Datenabfolge korrekt angezeigt wird.
Das kann passieren, wenn Sie nicht über alle erforderlichen Berechtigungen in den Speicherprojekten der Tabelle verfügen.
Beispiel:
- BigQuery-Tabelle
docs-source.dataset.source-001
- BigQuery-Tabelle
docs-target.dataset.target-001
- Datenabfolge zwischen
docs-source.dataset.source-001
unddocs-target.dataset.target-001
mit Berechnungsprojektdocs-compute
- Sie haben die Rolle Data Lineage-Betrachter für die aktiven und Compute-Projekte
docs-compute
In diesem Fall wird beim Klicken auf die BigQuery-Knotendetails eine Meldung Entry with this fully qualified name is not available in the
Dataplex Catalog
angezeigt.

Um dieses Problem zu beheben, gewähren Sie bigquery.tables.get
die Berechtigungen, die beispielsweise in der Rolle „BigQuery-Datenbetrachter“ enthalten sind, im Speicherprojekt.