Replica dei dati dal database Oracle a BigQuery

---

Questo tutorial mostra come eseguire il deployment di un job che replica continuamente i dati modificati da un database Oracle a un set di dati BigQuery utilizzando la replica di Cloud Data Fusion. Questa funzionalità è basata su Datastream.

Obiettivi

In questo tutorial:

1. Configura il database Oracle per abilitare il logging supplementare.
2. Crea ed esegui un job di replica Cloud Data Fusion.
3. Visualizza i risultati in BigQuery.

Costi

In questo documento utilizzi i seguenti componenti fatturabili di Google Cloud:

• Cloud Data Fusion
• Datastream
• BigQuery
• Cloud Storage
• Dataproc
• Compute Engine

Per generare una stima dei costi in base all'utilizzo previsto, utilizza il Calcolatore prezzi. I nuovi Google Cloud utenti potrebbero avere diritto a una prova gratuita.

Quando viene eseguita la replica, ti vengono addebitati i costi del cluster Dataproc e di Cloud Storage e devi sostenere i costi di elaborazione per Datastream e BigQuery. Per ottimizzare questi costi, consigliamo vivamente di utilizzare i prezzi a tariffa fissa di BigQuery.

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Cloud Data Fusion, Dataproc, Datastream, BigQuery, and Cloud Storage APIs.

   Enable the APIs

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

   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

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Cloud Data Fusion, Dataproc, Datastream, BigQuery, and Cloud Storage APIs.

   Enable the APIs

8. Crea un'istanza Cloud Data Fusion pubblica nella versione 6.3.0 o successive. Se crei un'istanza privata, configura il peering di rete VPC.
   • Quando crei l'istanza, abilita la replica facendo clic su Aggiungi acceleratori e selezionando la casella di controllo Replica.
   • Per attivarla in un'istanza esistente, consulta Attivare la replica.

Importante: devi attivare la replica nell'istanza affinché venga visualizzata nell'interfaccia web di Cloud Data Fusion Menu (vedi Attivare la replica).

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per connetterti a un database Oracle, chiedi all'amministratore di concederti i seguenti ruoli IAM:

• Nodo di lavoro Dataproc (roles/dataproc.worker) nell'account di servizio Dataproc del progetto che contiene il cluster
• Cloud Data Fusion Runner nell'account di servizio Dataproc nel progetto che contiene il cluster
• Amministratore DataStream (roles/datastream.admin) nell'account di servizio Cloud Data Fusion e nell'account di servizio Dataproc

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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

(Facoltativo) Installa Oracle in Compute Engine

Questa sezione mostra come configurare un database di esempio. Se hai già installato un database Oracle, puoi saltare questa sezione.

Nota: Datastream supporta solo versioni specifiche del database Oracle.

1. Scarica un'immagine Docker di Oracle Server.

   Per le limitazioni di questa immagine Oracle Express Edition 11g, consulta Versioni di Oracle Database.

2. Esegui il deployment dell'immagine Docker su una nuova istanza VM.

   Nota: per eseguire il deployment dell'immagine nella nuova istanza VM, il servizio Compute Engine deve disporre del ruolo Lettore del registry degli elementi (roles/artifactregistry.reader).

3. Nella pagina Dischi di Compute Engine, imposta le dimensioni del disco su 500 GB e riavvia la VM.

   Vai a Dischi

4. Installa lo schema di esempio per le risorse umane.

Crea un peering di rete VPC o una regola firewall per il tuo server Oracle

Se il tuo database Oracle non consente il traffico in entrata da indirizzi IP pubblici, configura il peering della rete VPC tra il VPC Datastream e il VPC a cui è possibile accedere al database Oracle. Per ulteriori informazioni, consulta Creare una configurazione di connettività privata.

Se il database Oracle consente il traffico in entrata da indirizzi IP pubblici, crea una regola firewall per l'istanza VM in modo da consentire il traffico in entrata da IP pubblici di Datastream.

Configurare Oracle Server per attivare il logging supplementare

Segui i passaggi per configurare il database Oracle di origine.

Creare ed eseguire un job di replica Cloud Data Fusion

Crea il job

1. Nell'interfaccia web di Cloud Data Fusion, fai clic su Replicazione.

2. Fai clic su Crea un job di replica.

3. Nella pagina Crea nuovo job di replica, specifica un Nome per il job di replica e fai clic su Avanti.

4. Configura l'origine:

   1. Seleziona Oracle (da Datastream) come origine.

   2. Per Metodo di connettività, se il server Oracle consente il traffico in entrata dagli IP pubblici di Datastream, scegli Lista consentita IP. In caso contrario, in Nome connessione privata, scegli Connettività privata (peering VPC) e inserisci il nome del peering VPC che hai creato nella sezione Creare una regola firewall o un peering di rete VPC per il tuo server Oracle.

   3. In Host, inserisci il nome host del server Oracle da leggere.

   4. In Port (Porta), inserisci la porta da utilizzare per connetterti al server Oracle: 1521.

   5. In Identità sistema, inserisci xe (il nome del database di esempio del server Oracle).

   6. Nella sezione delle credenziali, inserisci il tuo nome utente e la password per accedere al server Oracle.

   7. Lascia invariate tutte le altre proprietà.

5. Fai clic su Avanti.

6. Configura il target:

   1. Seleziona il target BigQuery.

   2. L'ID progetto e la chiave dell'account di servizio vengono rilevati automaticamente. Mantieni invariati i valori predefiniti.

   3. (Facoltativo) Nella sezione Avanzate, puoi configurare quanto segue:

      • Nome e posizione del bucket di staging
      • Intervallo di caricamento
      • Prefisso della tabella di gestione temporanea
      • Comportamento quando vengono eliminate tabelle o database

7. Fai clic su Avanti.

8. Se la connessione viene stabilita, viene visualizzato un elenco di tabelle. Per questo tutorial, seleziona alcune tabelle.

   Nota: per procedere, è necessario attivare il logging supplementare nelle tabelle selezionate.

9. Fai clic su Avanti.

10. Nella pagina di revisione della valutazione, fai clic su Visualizza mappature in una delle tabelle per ottenere una valutazione dei problemi relativi allo schema, delle funzionalità mancanti o dei problemi di connettività che potrebbero verificarsi durante la replica.

    In caso di problemi, devi risolverli prima di procedere. Per questo tutorial, se una delle tabelle presenta problemi, svolgi i seguenti passaggi:

    1. Torna al passaggio in cui hai selezionato le tabelle.
    2. Seleziona una tabella o un evento (inserimenti, aggiornamenti o eliminazioni) senza problemi.

    Per ulteriori informazioni sulle conversioni dei tipi di dati dal database di origine alla destinazione BigQuery, consulta Tipi di dati di replica.

11. Fai clic su Indietro.

12. Fai clic su Avanti.

13. Esamina i dettagli del job di replica di riepilogo e poi fai clic su Esegui il deployment del job di replica.

Avvia il job

1. Nell'interfaccia web di Cloud Data Fusion, vai alla pagina Dettagli del job di replica.

2. Fai clic su Avvia.

Il job di replica passa dallo stato Provisioning a Avvio e poi a In esecuzione. Nello stato di esecuzione, il job di replica carica in BigQuery uno snapshot iniziale dei dati della tabella selezionati. In questo stato, lo stato della tabella è indicato come Acquisizione istantanea. Dopo aver caricato lo snapshot iniziale in BigQuery, eventuali modifiche apportate alla tabella vengono replicate in BigQuery e lo stato della tabella è indicato come Replicating.

Monitora il job

Puoi avviare e interrompere il job di replica, esaminarne la configurazione e i log e monitorarlo.

Puoi monitorare le attività dei job di replica dalla pagina Dettagli job di replica.

1. Nella pagina Replicazione, fai clic sul Nome del job di replica che ti interessa.

2. Fai clic su Monitoraggio.

Visualizza i risultati in BigQuery

Il job di replica crea un set di dati e una tabella replicati in BigQuery, con i nomi ereditati dal database e dalle tabelle Oracle corrispondente.

Nota: se il nome del database di origine non segue le convenzioni di denominazione dei set di dati BigQuery o se si verificano conflitti di denominazione durante la replica di più set di dati in un singolo set di dati BigQuery, specifica gli alias nelle proprietà di destinazione BigQuery.

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

2. Nel riquadro a sinistra, fai clic sul nome del progetto per espandere un elenco di set di dati.

3. Seleziona il set di dati xe, quindi una tabella da visualizzare.

Per ulteriori informazioni, consulta la documentazione di BigQuery.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Al termine del tutorial, elimina le risorse che hai creato su Google Cloud in modo che non occupino quota e non ti vengano addebitate in futuro. Le seguenti sezioni descrivono come eliminare o disattivare queste risorse.

Elimina l'istanza VM

1. Nella console Google Cloud, vai alla pagina Istanze VM.

   Vai a Istanze VM

2. Seleziona la casella di controllo per l'istanza da eliminare.

3. Per eliminare l'istanza, fai clic su Elimina.

Elimina l'istanza Cloud Data Fusion

Segui le istruzioni per eliminare l'istanza Cloud Data Fusion.

Elimina il progetto

Il modo più semplice per eliminare la fatturazione è eliminare il progetto che hai creato per il tutorial.

Per eliminare 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, quando lo elimini elimini anche tutto il lavoro 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, il riuso dei progetti può aiutarti a non superare i limiti di quota.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Passaggi successivi

• Scopri di più su Datastream.
• Scopri di più sulla replica in Cloud Data Fusion.
• Consulta il riferimento all'API Replication.
• Consulta il riferimento alla replica di Oracle.
• Segui il tutorial sulla replica dei dati da MySQL a BigQuery.
• Segui il tutorial sulla replica dei dati da SQL Server a BigQuery.