Replica i dati da YugabyteDB all'elaborazione delle transazioni AI autonoma

Prima di iniziare

Per completare correttamente questo avvio rapido, assicurarsi di avere:

Un'installazione di YugabyteDB da utilizzare come database di origine
Un'istanza di Autonomous AI Transaction Processing da utilizzare come database di destinazione.
YugabyteDB preparato per Oracle GoldenGate

Impostare YugabyteDB

Per impostare l'istanza YugabyteDB, effettuare le operazioni riportate di seguito.

Se si utilizza Oracle Cloud Compute per ospitare YugabyteDB, aprire la porta 5433:

sudo firewall-cmd --permanent --add-port=5432/tcp
sudo firewall-cmd --reload 
sudo firewall-cmd --list-all

Aprire la porta 5433 nella lista di sicurezza della VCN.
Connetti a YugabyteDB.
Downlaod dei dati di esempio.
Eseguire i comandi riportati di seguito per impostare l'utente. Assicurarsi di sostituire il segnaposto <password> con una password effettiva.
```
create user ggadmin with password '<password>'; 
alter user ggadmin with SUPERUSER; 
GRANT ALL PRIVILEGES ON DATABASE ociggll TO ggadmin; 
```

Impostazione dell'ambiente: Autonomous AI Transaction Processing (ATP)

Scaricare ed estrarre lo schema di database di esempio.
Sbloccare l'utente GGADMIN.
1. Nella console di Oracle Cloud, selezionare l'istanza ATP dalla pagina Database AI autonomo per visualizzarne i dettagli e accedere a Database Actions.
2. Fare clic su Azioni database, quindi su Utenti database.
3. Individuare GGADMIN, quindi fare clic sul relativo menu con i puntini di sospensione (tre punti) e selezionare Modifica.
4. Nel pannello Modifica utente, immettere la password GGADMIN, confermare la password, quindi deselezionare Account bloccato.
5. Fare clic su Applica modifiche.
Caricare lo schema e i dati di esempio di destinazione.
1. Dal menu Azioni database, selezionare SQL.
2. Copiare e incollare lo script da OCIGGLL_OCIGGS_SETUP_USERS_ADW.sql nel foglio di lavoro SQL.
3. Fare clic su Esegui script Nella scheda Output script vengono visualizzati i messaggi di conferma.
4. Cancellare il foglio di lavoro SQL, quindi copiare e incollare l'istruzione SQL da OCIGGLL_OCIGGS_SRC_MIRROR_USER_SEED_DATA.sql.
5. Per verificare che le tabelle siano state create correttamente, chiudere la finestra SQL e riaprirla. Nella scheda Navigator, cercare lo schema SRC_OCIGGLL, quindi selezionare le tabelle dai rispettivi elenchi a discesa.

Task 1: creare le risorse di OCI GoldenGate

Questo esempio di avvio rapido richiede distribuzioni e connessioni sia per l'origine che per la destinazione.

Creare una distribuzione per il database PostgreSQL di origine.
Creare una distribuzione per l'istanza di Autonomous AI Transaction Processing di destinazione.
Creare una connessione al database PostgreSQL di origine.
1. Per Tipo, assicurarsi di selezionare YugabyteDB.
2. Per Nome database, immettere il nome YugabyteDB.
3. Per Host, immettere l'IP pubblico dell'istanza di computazione su cui viene eseguito YugabyteDB.
4. Per Porta, immettere 5433.
5. Per Nome utente, immettere ggadmin.
6. Per la password, immettere una password.
7. Per Protocollo di sicurezza, selezionare Plain.
Creare una connessione per l'istanza di Autonomous AI Transaction Processing di destinazione.
Creare una connessione a GoldenGate, quindi assegnare questa connessione alla distribuzione PostgreSQL di origine.
Assegnare la connessione di origine alla distribuzione PostgreSQL di origine.
Assegnare la connessione di destinazione alla distribuzione Oracle di destinazione.

Task 2: Abilita log supplementare

Per abilitare il log supplementare, procedere come segue.

Avviare la console di distribuzione PostgreSQL GoldenGate:
1. Nella pagina Distribuzioni selezionare la distribuzione PostgreSQL per visualizzarne i dettagli.
2. Nella pagina dei dettagli della distribuzione PostgreSQL fare clic su Avvia console.
3. Nella pagina di connessione della console di distribuzione, immettere le credenziali di amministratore GoldenGate fornite in precedenza quando è stata creata la distribuzione.
  
  Nota
  L'accesso è necessario se IAM non è stato selezionato come area di memorizzazione delle credenziali durante la creazione di una distribuzione.
In GoldenGate 26ai, fare clic su Connessioni DB nella navigazione a sinistra, quindi sul database YugabyteDB di origine, quindi su Trandata.
Nella pagina TRANDATA, accanto a Informazioni TRANDATA, fare clic su Aggiungi TRANDATA (icona più).
Nel pannello Trandata, in Nome schema, immettere src_ociggll.*, quindi fare clic su Sottometti.

Nota
Utilizzare il campo di ricerca per cercare src_ociggll e verificare che le tabelle siano state aggiunte.

Task 3: Creazione delle estrazioni

Aggiungere Change Data Capture Extract:
1. Nella navigazione a sinistra fare clic su Estrazioni,
2. Nella pagina Estrazioni, fare clic su Aggiungi Estrai (icona più), quindi completare i campi come indicato di seguito.
  - Nella pagina Informazioni estrazione:
    1. Per il tipo Estrai, selezionare Modifica acquisizione dati Estrai.
    2. In Nome processo, immettere un nome per Estrai, ad esempio ECDC.
    3. Fare clic su Successivo.
  - Nella pagina Opzioni Estrai:
    1. Per le credenziali di origine, selezionare Oracle GoldenGate dall'elenco a discesa Dominio
    2. Selezionare il database PostgreSQL di origine dall'elenco a discesa Alias.
    3. Per il nome trail Estrai, immettere un nome trail di due caratteri, ad esempio C1.
    4. Fare clic su Successivo.
  - Nella pagina Parametri Estrai, sostituire MAP *.*, TARGET *.*; con quanto segue:
```
TABLE SRC_OCIGGLL.*;
```
3. Fare clic su Crea ed esegui.
Aggiunta del caricamento iniziale Estrazione:
1. Nella pagina Estrazioni, fare clic su Aggiungi Estrai, quindi completare il form Aggiungi Estrai come indicato di seguito.
  - Nella pagina Informazioni estrazione:
    1. Per il tipo Estrai, selezionare Carico iniziale Estrai.
    2. In Nome processo, immettere un nome, ad esempio EIL.
    3. Fare clic su Successivo.
  - Nella pagina Opzioni Estrai:
    1. Per le credenziali di origine, selezionare Oracle GoldenGate dall'elenco a discesa Dominio.
    2. Selezionare YugabyteDB dall'elenco a discesa Alias.
    3. Per Nome trail estrazione, immettere un nome trail di due caratteri, ad esempio I1.
    4. Fare clic su Successivo.
  - Nella pagina Parametri Estrai sostituire il contenuto dell'area di testo con quanto riportato di seguito.
```
EXTRACT EIL
USERIDALIAS YugabyteDB_Compute, DOMAIN OracleGoldenGate
EXTFILE I1, PURGE
TABLE src_ociggll.*;
```
    Nota
    Assicurarsi di rimuovere il parametro SOURCEDB prima di passare a USERIDALIAS.
2. Fare clic su Crea ed esegui.

Si torna alla pagina Estrazioni, in cui è possibile osservare l'avvio di Estrai.

Task 4: Creare Distribution Path per Initial Load Estrai

Nella pagina Distribuzioni selezionare la distribuzione Oracle di destinazione.
Nella pagina dei dettagli della distribuzione fare clic su Avvia console, quindi eseguire il login come utente amministratore.
Se si utilizza l'area di memorizzazione delle credenziali IAM, passare al passo Crea Distribution Path. 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. Nel menu di navigazione, fare clic su Amministrazione utenti.
2. Fare clic su Aggiungi nuovo utente (icona più), completare i campi come indicato di seguito, quindi fare clic su Sottometti.
  - Per Nome utente, immettere ggsnet.
  - Per Ruolo, selezionare Operatore.
  - Immettere due volte la password per la verifica.
Nella console di distribuzione PostgreSQL di origine creare una connessione percorso per l'utente creato nel passo precedente.
1. Nel menu di navigazione, fare clic su Connessioni percorso.
2. Fare clic su Aggiungi connessione percorso (icona più), completare i campi come indicato di seguito, quindi fare clic su Sottometti.
  - Per l'alias credenziali, immettere dpuser.
  - Per ID utente, immettere ggsnet
  - Per Password, immettere la stessa password utilizzata nel passo precedente.
Creare un file Distribution Path.
1. Nella barra dei menu Servizio, fare clic su Distribution Service, quindi su Aggiungi Distribution Path (icona più).
2. Completare il modulo Aggiungi percorso come indicato di seguito.
  - Nella pagina Informazioni percorso:
    1. In Nome percorso, immettere un nome per questo percorso.
    2. Fare clic su Successivo.
  - Nella pagina Opzioni origine, effettuare le operazioni riportate di seguito.
    1. Per Origine Extract, lasciare vuoto.
    2. Per Nome percorso, immettere il nome trail Initial Load Extract (I1).
    3. Fare clic su Successivo.
  - Nella pagina Opzioni destinazione, effettuare le operazioni riportate di seguito.
    1. Per Protocollo di destinazione, selezionare wss.
    2. Per Host di destinazione, immettere l'URL di distribuzione di destinazione senza le barre https:// o le barre finali.
    3. In Numero porta, immettere 443.
    4. Per Nome percorso, immettere I1.
    5. Per Metodo di autenticazione di destinazione, selezionare OAuth.
      
      Nota
      Selezionare Alias ID utente se GoldenGate è stato selezionato come area di memorizzazione delle credenziali durante la creazione di una distribuzione. In alternativa, selezionare OAuth.
    6. Per Dominio, immettere il nome di dominio creato nel passo precedente.
    7. Per Alias, immettere l'alias creato nel passo precedente (dpuser).
    8. Fare clic su Successivo.
3. Fare clic su Crea ed esegui.
Si torna alla pagina Distribution Service in cui è possibile rivedere il percorso creato.
Nella console di distribuzione target di Oracle, esaminare il percorso del destinatario creato come risultato del percorso di distribuzione:
1. Fare clic su Receiver Service.
2. Rivedere i dettagli di Distribution Path.

Task 5: aggiungere un Replicat per Initial Load

Nella distribuzione Oracle di destinazione, aggiungere una tabella Checkpoint.
1. Nel menu di navigazione fare clic su Connessioni DB.
2. Selezionare l'istanza di destinazione Autonomous AI Database, quindi Checkpoints.
3. Nella pagina Checkpoints, fare clic su Aggiungi checkpoint (icona più).
4. Nel pannello Checkpoint, per Tabella schema, immettere SRCMIRROR_OCIGGLL.CHECKTABLE.
5. Fare clic su Sottometti.
Aggiungere il valore Replicat.
1. Nel menu di Navigazione fare clic su Replicats.
2. Nella pagina Replicats fare clic su Aggiungi Replicat (icona più), quindi completare i campi Aggiungi Replicat come indicato di seguito.
  - Nella pagina Replicat Informazioni:
    1. Per il tipo Replicat, selezionare Nonintegrated Replicat.
    2. In Nome processo, immettere un nome, ad esempio RIL.
    3. Fare clic su Successivo.
  - Nella pagina Opzioni Replicat:
    1. Per Replicat Nome trail, immettere il nome del trail dal task 2 (I1).
    2. Per le credenziali di destinazione, selezionare il dominio e le alias per la connessione al database AI autonomo.
    3. Per Tabella checkpoint, selezionare la tabella Checkpoint creata nel Passo 1.
    4. Fare clic su Successivo.
  - Nella pagina File dei parametri, sostituire MAP *.*, TARGET *.*; con quanto segue:
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
3. Fare clic su Crea ed esegui.
  Si torna alla pagina Replicats, dove è possibile rivedere i dettagli di Replicat.
Selezionare Replicat (RIL) e visualizzarne i dettagli.
Fare clic su Statistiche ed esaminare il numero di inserimenti. Aggiornare la pagina.
- Se il numero di inserimenti non cambia, tutti i record di Initial Load sono stati caricati ed è possibile arrestare Replicat (RIL)
- Se il numero di inserimenti continua ad aumentare, continuare ad aggiornare la pagina finché non vengono caricati tutti i record Initial Load prima di continuare.
Verificare Initial Load.
1. Nella console di Oracle Cloud, nella pagina dei dettagli di Autonomous AI Database, fare clic su Azioni del database, quindi su SQL.
2. Nello strumento SQL immettere nel foglio di lavoro ciascuna delle istruzioni seguenti e fare clic su Esegui istruzione:
```
SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CITY;
SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CUSTOMER;
```
L'output deve restituire i dati caricati nelle tabelle del database di destinazione come risultato di Initial Load.

Task 6: Creare un Distribution Path per Change Data Capture Extract

Nella console di distribuzione PostgreSQL di origine, fare clic su Distribution Service.
Fare clic su Aggiungi Distribution Path.
Completare il modulo Aggiungi percorso come indicato di seguito.
1. Nella pagina Informazioni percorso:
  1. In Nome percorso, immettere un nome.
  2. Fare clic su Successivo.
2. Nella pagina Opzioni origine, effettuare le operazioni riportate di seguito.
  1. Per Origine Extract, selezionare Change Data Capture Extract (ECDC)).
  2. In Nome percorso, selezionare il file trail Change Data Capture (C1).
  3. Fare clic su Successivo.
3. Nella pagina Opzioni destinazione, effettuare le operazioni riportate di seguito.
  1. Per Destinazione, selezionare wss.
  2. Per Host di destinazione, immettere l'URL della console di distribuzione di destinazione, disponibile nella pagina dei dettagli della distribuzione, senza le barre https:// o le barre finali.
  3. In Numero porta, immettere 443.
  4. Per Nome percorso, immettere C1.
  5. Per Metodo di autenticazione di destinazione, selezionare OAuth.
    
    Nota
    Selezionare Alias ID utente se GoldenGate è stato selezionato come area di memorizzazione delle credenziali durante la creazione di una distribuzione. In alternativa, selezionare OAuth.
  6. Per Dominio, immettere il nome del dominio.
  7. Per Alias, immettere l'alias.
4. Fare clic su Crea percorso ed esegui.
Nella console di distribuzione Oracle di destinazione, fare clic su Servizio ricevente, quindi rivedere il percorso del ricevente creato.

Task 7: aggiungere un valore Replicat per Change Data Capture

Nella console di distribuzione Oracle destinazione, aggiungere un valore Replicat.
1. Nel menu di navigazione Servizio di amministrazione, fare clic su Replicats.
2. Nella pagina Replicats fare clic su Aggiungi Replicat (icona più), quindi completare il modulo Aggiungi Replicat come indicato di seguito.
  - Nella pagina Informazioni Replicat:
    1. Per il tipo Replicat, selezionare Nonintegrated Replicat.
    2. In Nome processo, immettere un nome, ad esempio RCDC.
    3. Fare clic su Successivo.
  - Nella pagina Opzioni Replicat:
    1. Per Replicat Nome trail, immettere il nome del trail dal task 3 (C1).
    2. Per Credenziali di destinazione, selezionare il dominio e l'alias per la connessione Autonomous AI Database.
    3. Per Tabella checkpoint, selezionare la tabella Checkpoint.
  - Nella pagina Parametri Replicat sostituire MAP *.*, TARGET *.*; con il mapping seguente:
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
3. Fare clic su Crea. Non eseguire il comando Replicat.
Nella pagina Replicats, selezionare Replicat per Initial Load (RIL) e visualizzare i relativi dettagli.
Fare clic su Statistiche ed esaminare il numero di inserimenti. Aggiornare la pagina.
- Se il numero di inserti non cambia, tutti i record di Initial Load sono stati caricati ed è possibile arrestare Replicat (RIL)
- Se il numero di inserimenti continua ad aumentare, continuare ad aggiornare la pagina finché non vengono caricati tutti i record Initial Load prima di continuare.
Nota
Se non vengono visualizzati inserimenti, fare clic su Servizio metriche prestazioni, selezionare Estrai, quindi fare clic su Statistiche database.
Tornare alla pagina Replicats, quindi avviare Replicat per Change Data Capture (RCDC).
Dopo aver avviato Replicat per Change Data Capture, esaminare i relativi Dettagli e Statistiche per visualizzare il numero di inserzioni.

Verifica replica:

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

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);

Nella console di distribuzione PostgreSQL di origine, selezionare Change Data Capture Extract (ECDC), quindi fare clic su Statistiche. Verificare che in src_ociggll.src_city siano presenti 10 inserimenti.

Nota
Se Extract non ha acquisito alcun inserimento, riavviare ECDC Extract.
Nella console di distribuzione Oracle di destinazione, selezionare il nome Replicat (RCDC), visualizzarne i dettagli, quindi selezionare Statistiche. Verificare che in SRCMIRROR_OCIGGLL.SRC_CITY siano presenti 10 inserimenti.