Invia dati da HeatWave agli hub eventi di Azure

Scopri come utilizzare OCI GoldenGate per replicare i dati da HeatWave agli hub di eventi di Azure.

Prima di iniziare

Per completare correttamente questo avvio rapido, è necessario disporre dei seguenti elementi:

OCI Bastion, per connettersi al database HeatWave, caricare il database di esempio ed eseguire inserimenti.
Database HeatWave da utilizzare come database di origine.
Spazio di nomi degli hub eventi di Azure e hub eventi creati

Nota: Kafka Surface non è abilitato nel livello base degli hub eventi di Azure. Il livello Standard o Premium è obbligatorio.

Impostazione dell'ambiente: HeatWave

Per impostare l'ambiente per questo Quickstart:

Scaricare lo script dei dati di esempio, quindi eseguire lo script nel database HeatWave per creare il database e caricare i dati.

Creare un utente ggadmin utilizzando lo script seguente. Ricordarsi di sostituire <ggadmin-password> con una password valida:

CREATE USER 'ggadmin' IDENTIFIED BY '<ggadmin-password>';
GRANT SELECT, REPLICATION SLAVE, REPLICATION CLIENT, CREATE,CREATE VIEW, EVENT, INSERT, UPDATE, DROP,EXECUTE, DELETE ON *.* TO 'ggadmin';

Aprire port 3306, tramite il quale OCI GoldenGate può connettersi.
1. Nella console di Oracle Cloud, individuare la subnet utilizzata dal database HeatWave.
2. Nella lista di sicurezza della subnet creare una regola di entrata per port TCP/3306.

Task 1: creare le risorse OCI GoldenGate

Crea una distribuzione MySQL per il database HeatWave di origine.
Creare una distribuzione Big Data per gli hub eventi di Azure di destinazione.
Creare una connessione al database MySQL Heatwave di origine.
Creare una connessione di hub eventi Azure.
Creare una connessione a GoldenGate, quindi assegnare questa connessione alla distribuzione MySQL di origine.
Assegnare la connessione di origine alla distribuzione MySQL di origine.
Assegnare la connessione di destinazione alla distribuzione Big Data di destinazione.

Task 2: Creazione dell'estrazione

Nella pagina Distribuzioni selezionare la distribuzione MySQL creata nel task 1.
Nella pagina dei dettagli della distribuzione selezionare Avvia console.
Connettersi alla console di distribuzione MySQL di origine utilizzando le credenziali di amministratore specificate durante la creazione della distribuzione nel task 1.
Aggiungi estrazione anChange Data Capture con i valori riportati di seguito.
- Tipo di estrazione: Estrazione acquisizione dati modifica
- Nome processo: ECDC
- Nome trail estrazione: C1
- File dei parametri: sostituire MAP *.*, TARGET *.*; con TABLE SRC_OCIGGLL.*;

Task 3: Creare il percorso di distribuzione per la distribuzione dei Big Data di destinazione

Se si utilizza l'area di memorizzazione delle credenziali IAM, procedere al passo 3. Se si utilizza l'area di memorizzazione delle credenziali GoldenGate, creare un utente con il quale GoldenGate di origine utilizza per connettersi a GoldenGate di destinazione.
1. Nella pagina Distribuzioni selezionare la distribuzione dei Big Data di destinazione.
2. Nella pagina dei dettagli della distribuzione, selezionare Avvia console, quindi eseguire il login come utente amministratore.
3. Nel menu di navigazione della console di distribuzione selezionare Amministrazione utenti.
4. Selezionare Aggiungi nuovo utente (icona più), completare i campi come indicato di seguito, quindi selezionare Sottometti.
  - Per Nome utente, immettere ggsnet.
  - Per Ruolo, selezionare Operatore.
  - Immettere due volte la password per la verifica.
Nella console di distribuzione MySQL di origine, creare una connessione percorso per l'utente creato nel passo precedente.
1. Aprire il menu di navigazione, quindi selezionare Path Connection.
2. Selezionare Aggiungi connessione percorso (icona più), completare i campi come indicato di seguito, quindi selezionare Sottometti.
  - Per Alias credenziale, immettere dpuser.
  - Per ID utente, immettere ggsnet
  - Per Password, immettere la stessa password utilizzata nel passo precedente.
Nella console di distribuzione di origine MySQL aggiungi il percorso di aDistribution con i seguenti valori:
1. Nella pagina Opzioni di origine effettuare le operazioni riportate di seguito.
  - Per Estrazione origine, selezionare l'estrazione creata nel task 2.
  - In Nome percorso, immettere un nome di due caratteri, ad esempio C1.
2. Nella pagina Opzioni di destinazione effettuare le operazioni riportate di seguito.
  - Per Host di destinazione, immettere il dominio host della distribuzione di destinazione.
  - In Numero porta, immettere 443.
  - In Nome percorso, immettere un nome di due caratteri, ad esempio C1.
  - In Alias, immettere l'alias credenziale creato nel Passo 2.
Nella console di distribuzione OCI GoldenGate Big Data di destinazione, esaminare il percorso del destinatario creato in seguito al percorso di distribuzione:
1. Selezionare Servizio ricevente.
2. Rivedere i dettagli del percorso del ricevente.

Task 4: Aggiungere un Replicat per gli hub eventi di Azure

Nella distribuzione Big Data, selezionare Servizio amministratore, quindi selezionare Aggiungi replica (icona più).
Aggiungere aReplicat con i seguenti valori:
1. Nella pagina Informazioni Replicat, in Tipo Replicat, selezionare Replicat classico e immettere un nome di processo.
2. Nella pagina Opzioni Replicat:
  - In Nome percorso, immettere il nome del trail dal task 2.
  - Per Destinazione, selezionare un hub eventi di Azure.
  - In Alias selezionare la connessione degli hub eventi di Azure creata nel task 1.
3. Nella pagina Parametri replica, lasciare l'impostazione predefinita.
4. Nella pagina File delle proprietà, fornire un nome di argomento per topicMappingTemplate.
5. Selezionare Crea ed esegui.

Task 5: Verifica replica dati da hub eventi HeatWave ad Azure

Eseguire gli aggiornamenti al database HeatWave di origine per verificare la replica negli hub eventi di Azure.

In OCI Bastion creare una sessione di inoltro della porta SSH utilizzando MySQL IP e port 3306. Aggiungere la chiave SSH pubblica.
Connettiti a MySQL in Cloud Shell utilizzando la tua chiave privata e port 3306.
Dopo aver eseguito correttamente la connessione, eseguire il comando seguente:
```
mysqlsh admin@localhost:3306 --sql
```

Eseguire lo script seguente per eseguire gli inserimenti nel database HeatWave:

use SRC_OCIGGLL;
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1000,'Houston',20,743113);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1001,'Dallas',20,822416);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1002,'San Francisco',21,157574);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1003,'Los Angeles',21,743878);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1004,'San Diego',21,840689);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1005,'Chicago',23,616472);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1006,'Memphis',23,580075);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1007,'New York City',22,124434);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1008,'Boston',22,275581);
Insert into SRC_OCIGGLL.SRC_CITY (CITY_ID,CITY,REGION_ID,POPULATION) values (1009,'Washington D.C.',22,688002);
commit;

Nella console di distribuzione MySQL di origine, selezionare il nome Estrazione acquisizione dati modifica, quindi selezionare Statistiche. Verificare che in SRC_OCIGGLL.SRC_CITY siano presenti 10 inserimenti.
Nella console di distribuzione Big Data di destinazione, selezionare il nome Replicat, quindi selezionare Statistiche. Verificare che in SRC_OCIGGLL.SRC_CITY siano presenti 10 inserimenti.
In Hub eventi di Azure è possibile controllare le statistiche dei messaggi.