Monitora la derivazione dei dati per una tabella BigQuery

Monitora la derivazione dei dati per una tabella BigQuery

La derivazione dei dati ti consente di monitorare la provenienza dei dati, il modo in cui vengono trasformati e il modo in cui si spostano tra le tabelle BigQuery nel tempo. Il monitoraggio di questi movimenti ti aiuta a mantenere la conformità, risolvere i problemi relativi ai dati ed eseguire l'analisi delle cause principali. In questa guida rapida, utilizzerai la consoleGoogle Cloud per copiare due tabelle new_york_taxi_trips pubbliche, combinare i relativi conteggi delle corse in una nuova tabella BigQuery e visualizzare il grafico di visualizzazione della derivazione. Per interagire con la derivazione dei dati in modo programmatico, consulta Librerie client di Knowledge Catalog e derivazione dei dati.

Prima di iniziare

Configura il progetto:

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

3. Verify that billing is enabled for your Google Cloud project.

4. Enable the Dataplex, BigQuery, and Data Lineage APIs, if any are not already enabled.

   Roles required to enable APIs

   To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

   Enable the APIs

Attenzione: la derivazione dei dati viene attivata in base al progetto, non al servizio. Dopo aver abilitato l'API Data Lineage, le informazioni sulla derivazione vengono segnalate automaticamente per più servizi Google Cloud nel progetto, a seconda del controllo della derivazione a livello di prodotto. Per maggiori dettagli, consulta Considerazioni e limitazioni relative alla derivazione dei dati.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare i grafici di visualizzazione della derivazione, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Dataplex Catalog Viewer (roles/dataplex.catalogViewer) nel progetto di risorse Knowledge Catalog (in precedenza Dataplex Universal Catalog)
• Visualizzatore di derivazione dei dati (roles/datalineage.viewer) nel progetto in cui utilizzi BigQuery
• BigQuery Data Viewer (roles/bigquery.dataViewer) sul progetto in cui utilizzi BigQuery

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Aggiungi un set di dati pubblico al tuo progetto

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su database Esplora dati.

   Se non vedi il riquadro a sinistra, fai clic su Espandi riquadro sinistro per aprirlo.

3. Nel riquadro Dati, fai clic su Aggiungi dati.

4. Nel riquadro Aggiungi dati, seleziona Set di dati pubblici.

5. Nel riquadro Marketplace, cerca NYC TLC Trips e fai clic sul risultato NYC TLC Trips.

6. Fai clic su Visualizza set di dati.

In questo modo, il progetto del set di dati pubblico viene aggiunto come riferimento che puoi visualizzare nel riquadro Explorer. Il riquadro dei dettagli mostra le Informazioni sul set di dati, tra cui ID set di dati, Località dei dati e data dell'Ultima modifica.

Crea un set di dati nel tuo progetto

1. Nel riquadro a sinistra, fai clic su Explorer.

2. Nel riquadro Explorer, seleziona il progetto in cui vuoi creare il set di dati.

3. Fai clic su Azioni e poi su Crea set di dati.

4. Nella pagina Crea set di dati, nel campo ID set di dati, inserisci: data_lineage_demo. Lascia invariati i valori predefiniti degli altri campi.

5. Fai clic su Crea set di dati.

6. Nel riquadro Explorer, fai clic su Set di dati, quindi sul set di dati appena aggiunto data_lineage_demo.

Il riquadro dei dettagli mostra le Informazioni sul set di dati.

Copia due tabelle accessibili pubblicamente nel tuo set di dati

1. Apri un editor di query: nel riquadro dei dettagli, accanto alla scheda denominata data_lineage_demo, fai clic su Query SQL. Questo passaggio crea una scheda denominata Untitled.

2. Nell'editor di query, copia la prima tabella inserendo la seguente query. Sostituisci PROJECT_ID con l'identificatore del progetto.

   CREATE TABLE `PROJECT_ID.data_lineage_demo.nyc_green_trips_2021`
   COPY `bigquery-public-data.new_york_taxi_trips.tlc_green_trips_2021`
   

3. Fai clic su Esegui. Questo passaggio crea la prima tabella, denominata nyc_green_trips_2021.

4. Nel riquadro Risultati delle query, fai clic su Vai alla tabella. Questo passaggio mostra i contenuti della prima tabella.

5. Nell'editor di query, copia la seconda tabella sostituendo la query precedente con la query seguente. Sostituisci PROJECT_ID con l'identificatore del progetto.

   CREATE TABLE `PROJECT_ID.data_lineage_demo.nyc_green_trips_2022`
   COPY `bigquery-public-data.new_york_taxi_trips.tlc_green_trips_2022`
   

6. Fai clic su Esegui. Questo passaggio crea la seconda tabella, denominata nyc_green_trips_2022.

7. Nel riquadro Risultati delle query, fai clic su Vai alla tabella. Questo passaggio mostra i contenuti della seconda tabella.

Aggrega i dati in una nuova tabella

1. Nell'editor di query, inserisci la query seguente. Sostituisci PROJECT_ID con l'identificatore del progetto.

   CREATE TABLE `PROJECT_ID.data_lineage_demo.total_green_trips_22_21`
   AS SELECT vendor_id, COUNT(*) AS number_of_trips
   FROM (
        SELECT vendor_id FROM `PROJECT_ID.data_lineage_demo.nyc_green_trips_2022`
        UNION ALL
        SELECT vendor_id FROM `PROJECT_ID.data_lineage_demo.nyc_green_trips_2021`
   )
   GROUP BY vendor_id
   

2. Fai clic su Esegui. Questo passaggio crea una tabella combinata denominata total_green_trips_22_21.

3. Nel riquadro Risultati delle query, fai clic su Vai alla tabella. Questo passaggio mostra la tabella combinata.

Visualizza il grafico di derivazione in Knowledge Catalog

1. Nella console Google Cloud , vai alla pagina Ricerca di Knowledge Catalog.

   Vai alla Ricerca

2. Nella casella Cerca, inserisci total_green_trips_22_21 e fai clic su Cerca.

3. Nell'elenco dei risultati, fai clic su total_green_trips_22_21. Questo passaggio mostra la scheda Dettagli della tabella BigQuery.

4. Fai clic sulla scheda Derivazione.

Nota: potrebbe essere necessario un po' di tempo prima che la derivazione automatica rilevi queste modifiche. Se non vedi ancora il grafico di derivazione, ricontrolla dopo qualche minuto.

Figura 1. Derivazione dei dati con i dettagli dei nodi

Nel grafico di derivazione, ogni nodo rettangolare rappresenta una tabella, che può essere originale, copiata o combinata. Puoi:

• Per mostrare o nascondere l'origine di una tabella, fai clic su + (Espandi) o - (Comprimi).

• Per visualizzare le informazioni sulla tabella, fai clic su un nodo. Questo passaggio mostra un riquadro Dettagli del nodo.

• Per visualizzare le informazioni sul processo, fai clic su . Questo passaggio mostra un riquadro Dettagli del processo che mostra il job che ha trasformato una tabella di origine in una tabella di destinazione.

Figura 2. Derivazione dei dati con i dettagli del processo

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Elimina il progetto

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella console Google Cloud , vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.

Eliminazione del set di dati

1. Nella console Google Cloud , vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro a sinistra, fai clic su Explorer.

3. Nel riquadro Spazio di esplorazione, cerca il set di dati data_lineage_demo che hai creato.

4. Fai clic sul set di dati, quindi su Elimina.

5. Conferma l'azione di eliminazione.

Passaggi successivi

• Scopri di più sulla derivazione dei dati.
• Scopri come eseguire query BigQuery.
• Scopri come utilizzare la derivazione dei dati.
• Scopri come utilizzare le librerie client di Knowledge Catalog e Data Lineage.
• Scopri di più sui prezzi di Knowledge Catalog.
• Prova i casi d'uso di Knowledge Catalog.