Questo documento descrive come risolvere i problemi relativi alla derivazione dei dati del Catalogo universale Dataplex.
Tipi di progetto
Gli asset di dati possono risiedere in progetti diversi. Di seguito è riportato un riepilogo dei possibili progetti e dei relativi nomi degli asset.
Progetto di archiviazione BigQuery
Questo progetto archivia gli asset di dati BigQuery.
Puoi trovarlo nei dettagli della risorsa come parte di Table ID
, prima del primo punto.

Progetto Compute
Questo progetto archivia i metadati di derivazione dei dati. Per BigQuery, è qui che esegui un job. Se esegui un job utilizzando la console Google Cloud , puoi trovare il nome del progetto di calcolo nel selettore di progetti:

Quando invii richieste all'API BigQuery, specifica il progetto di calcolo nell'URL, ad esempio:
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",
}
}
Progetto attivo
Questo è il progetto da cui stai visualizzando la derivazione dei dati. La console Google Cloud mostra il progetto attivo nel selettore di progetti. Se utilizzi l'API, il progetto attivo è quello da cui effettui chiamate API.

La derivazione dei dati BigQuery non viene visualizzata
Il seguente problema si verifica dopo l'esecuzione di un job BigQuery. In questo caso, il problema può essere causato da tre scenari:
- L'API Data Lineage è disabilitata nel progetto attivo o nel progetto di calcolo.
- Non disponi del ruolo Visualizzatore data lineage (
roles/datalineage.viewer
) nel progetto attivo o compute. - La derivazione dei dati non è ancora arrivata. A seconda del volume e della complessità dei dati in fase di elaborazione, la visualizzazione della derivazione dei dati può richiedere da 30 minuti standard fino a 24 ore.
Se nella parte inferiore della pagina viene visualizzato il messaggio "Impossibile recuperare la derivazione a causa di autorizzazioni mancanti", significa che non disponi delle autorizzazioni per il progetto attivo. In caso contrario, non disponi delle autorizzazioni per il progetto compute.

Per risolvere il problema, verifica se l'API Data Lineage è abilitata per il progetto di calcolo. Dopo aver abilitato l'API, devi eseguire un job per visualizzare la derivazione dei dati. A seconda del volume e della complessità dei dati in fase di elaborazione, la visualizzazione della derivazione dei dati può richiedere da 30 minuti standard fino a 24 ore.
Successivamente, verifica se l'API Data Lineage è abilitata per il progetto attivo.
Quando l'API Data Lineage è abilitata, concedi il
ruolo Visualizzatore Data Lineage (roles/datalineage.viewer
)
sia nel progetto attivo
sia in quello compute.
I metadati di processo BigQuery non vengono visualizzati
Il seguente problema si verifica quando apri il riquadro dei dettagli della tabella, che non
mostra tutti i dettagli come l'istruzione SQL o la proprietà Process type
.
Ciò si verifica anche se la derivazione dei dati viene visualizzata correttamente.
Ciò può verificarsi quando non disponi delle autorizzazioni per visualizzare i metadati nel progetto Compute.
Esempio:
- Tabella di origine BigQuery:
docs-source.dataset.source-001
- Tabella BigQuery di destinazione:
docs-target.dataset.target-001
- Lignaggio dei dati tra
docs-source.dataset.source-001
edocs-target.dataset.target-001
nel progetto di calcolodocs-compute
- Hai il ruolo Visualizzatore Data Lineage per i progetti attivi
e compute
docs-compute
.
Se fai clic sui dettagli del processo BigQuery, nella console Google Cloud viene visualizzato il seguente messaggio:
You don't have permission to view BigQuery process metadata in project X.

Per risolvere il problema, concedi all'utente l'autorizzazione bigquery.jobs.get
(inclusa, ad esempio, nel ruolo Visualizzatore risorse BigQuery)
nel progetto di calcolo.
I dettagli della tabella BigQuery non vengono visualizzati
Il seguente problema si verifica quando apri il riquadro dei dettagli della tabella, che mostra
solo la proprietà Fully qualified name
. Ciò si verifica anche se
la derivazione dei dati viene visualizzata correttamente.
Questo può accadere quando non disponi di tutte le autorizzazioni richieste nei
progetti di archiviazione della tabella.
Esempio:
- Tabella BigQuery
docs-source.dataset.source-001
- Tabella BigQuery
docs-target.dataset.target-001
- Derivazione dei dati tra
docs-source.dataset.source-001
edocs-target.dataset.target-001
con progetto di calcolodocs-compute
- Hai il ruolo Visualizzatore Data Lineage per i progetti attivi
e compute
docs-compute
In questo caso, quando fai clic sui dettagli del nodo BigQuery, puoi visualizzare un
messaggio Entry with this fully qualified name is not available in Dataplex
Universal Catalog or you do not have permissions to view it
.

Per risolvere il problema, concedi le autorizzazioni bigquery.tables.get
(ad esempio quelle incluse nel ruolo Visualizzatore dati BigQuery) nel progetto di archiviazione.