

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo di Oracle GoldenGate con Amazon RDS per Oracle
<a name="Appendix.OracleGoldenGate"></a>

Oracle GoldenGate raccoglie, replica e gestisce i dati transazionali tra database. È un pacchetto software con funzionalità Change Data Capture (CDC) e di replica basate su log che viene utilizzato con i database per i sistemi elaborazione di transazioni online (OLTP). Oracle GoldenGate crea file trail che contengono i dati modificati più recentemente dal database di origine. Quindi invia questi file al server, dove un processo converte il file trail in SQL standard da applicare al database di destinazione.

Oracle GoldenGate con RDS per Oracle supporta le seguenti funzionalità:
+ Replica di database attivo-attivo
+ Disaster recovery
+ Protezione dei dati
+ Replica in una regione e tra varie regioni
+ Migrazione e upgrade senza tempi di inattività
+ Replica dei dati tra un'istanza database RDS per Oracle e un database non Oracle
**Nota**  
Per l'elenco dei database supportati, consulta [Oracle Fusion Middleware Supported System Configurations](https://www.oracle.com/middleware/technologies/fusion-certification.html) (Configurazioni di sistema supportate per Oracle Fusion Middleware) nella documentazione di Oracle.

È possibile utilizzare Oracle GoldenGate con RDS for Oracle per eseguire l'aggiornamento alle versioni principali di Oracle Database. Ad esempio, puoi utilizzare Oracle per GoldenGate eseguire l'aggiornamento da un database locale Oracle Database 11g a Oracle Database 19c su un'istanza database Amazon RDS.

**Topics**
+ [

## Versioni e opzioni di licenza supportate per Oracle GoldenGate
](#Appendix.OracleGoldenGate.licensing)
+ [

## Requisiti e limitazioni per Oracle GoldenGate
](#Appendix.OracleGoldenGate.requirements)
+ [

# GoldenGate Architettura Oracle
](Appendix.OracleGoldenGate.Overview.md)
+ [

# Configurazione di Oracle GoldenGate
](Appendix.OracleGoldenGate.setting-up.md)
+ [

# Utilizzo delle utilità EXTRACT e REPLICAT di Oracle GoldenGate
](Appendix.OracleGoldenGate.ExtractReplicat.md)
+ [

# Monitoraggio di Oracle GoldenGate
](Appendix.OracleGoldenGate.Monitoring.md)
+ [

# Risoluzione dei problemi relativi a GoldenGate
](Appendix.OracleGoldenGate.Troubleshooting.md)

## Versioni e opzioni di licenza supportate per Oracle GoldenGate
<a name="Appendix.OracleGoldenGate.licensing"></a>

È possibile utilizzare Standard Edition 2 (SE2) o Enterprise Edition (EE) di RDS per Oracle con Oracle GoldenGate versione 12c e successive. È possibile utilizzare le seguenti funzionalità Oracle GoldenGate :
+ Oracle GoldenGate Remote Capture (estrazione) è supportato.
+ L'acquisizione (extract) è supportata nelle istanze database RDS per Oracle che utilizzano la tradizionale architettura di database non CDB. L'acquisizione di Oracle GoldenGate Remote PDB è supportata sull' CDBs esecuzione di Oracle Database 21c o Oracle Database 19c versione 19.0.0.0.ru-2024-04.rur-2024-04.r1 o successiva.
+ Oracle GoldenGate Remote Delivery (replicat) è supportato su istanze RDS per Oracle DB che utilizzano architetture non CDB o CDB. Remote Delivery supporta Integrated Replicat, Parallel Replicat, Coordinated Replicat e Classic Replicat.
+ RDS per Oracle supporta le architetture Classic e Microservices di Oracle. GoldenGate
+ La replica dei valori Oracle GoldenGate DDL e Sequence è supportata quando si utilizza la modalità di acquisizione integrata.

Sei responsabile della gestione delle GoldenGate licenze Oracle (BYOL) da utilizzare con Amazon RDS in generale. Regioni AWS Per ulteriori informazioni, consulta [Opzioni di licenza per RDS per Oracle](Oracle.Concepts.Licensing.md).

## Requisiti e limitazioni per Oracle GoldenGate
<a name="Appendix.OracleGoldenGate.requirements"></a>

Quando lavori con Oracle GoldenGate e RDS per Oracle, considera i seguenti requisiti e limitazioni: 
+ Sei responsabile della configurazione e della gestione di Oracle GoldenGate per l'utilizzo con RDS for Oracle. 
+ Sei responsabile della configurazione di una GoldenGate versione Oracle certificata con i database di origine e di destinazione. Per ulteriori informazioni, consulta [Oracle Fusion Middleware Supported System Configurations](https://www.oracle.com/middleware/technologies/fusion-certification.html) (Configurazioni di sistema supportate per Oracle Fusion Middleware) nella documentazione di Oracle.
+ Puoi utilizzare Oracle GoldenGate in molti AWS ambienti diversi per molti casi d'uso diversi. Se hai un problema relativo al supporto relativo a Oracle GoldenGate, contatta Oracle Support Services.
+ È possibile utilizzare Oracle GoldenGate su RDS per istanze Oracle DB che utilizzano Oracle Transparent Data Encryption (TDE). Per mantenere l'integrità dei dati replicati, configura la crittografia sull' GoldenGate hub Oracle utilizzando i volumi crittografati di Amazon EBS o la crittografia dei file trail. Configura anche la crittografia per i dati inviati tra l' GoldenGate hub Oracle e le istanze del database di origine e destinazione. Le istanze database RDS for Oracle supportano la crittografia con [Oracle Secure Sockets Layer](Appendix.Oracle.Options.SSL.md) o [Oracle native network encryption](Appendix.Oracle.Options.NetworkEncryption.md).

# GoldenGate Architettura Oracle
<a name="Appendix.OracleGoldenGate.Overview"></a>

L' GoldenGate architettura Oracle da utilizzare con Amazon RDS è costituita dai seguenti moduli disaccoppiati:

Database di origine  
Il database di origine può essere un database Oracle che si trova in locale, un database Oracle su un'istanza Amazon EC2 oppure un database Oracle su un'istanza database Amazon RDS.

Hub GoldenGate Oracle  
Un GoldenGate hub Oracle sposta le informazioni sulle transazioni dal database di origine al database di destinazione. L'hub può essere uno dei seguenti:  
+ Un'istanza Amazon EC2 con Oracle Database e Oracle installati GoldenGate 
+ Un'installazione Oracle on-premise
Puoi disporre di più hub Amazon EC2. Si consiglia di utilizzare due hub se si utilizza Oracle GoldenGate per la replica tra regioni.

Database di destinazione  
Il database di destinazione può trovarsi in un'istanza database Amazon RDS, in un'istanza Amazon EC2 o in un percorso locale.

Le seguenti sezioni descrivono gli scenari comuni per Oracle GoldenGate su Amazon RDS.

**Topics**
+ [

## Database di origine locale e hub Oracle GoldenGate
](#Appendix.OracleGoldenGate.on-prem-source-gg-hub)
+ [

## Database di origine on-premise e hub Amazon EC2
](#Appendix.OracleGoldenGate.on-prem-source-ec2-hub)
+ [

## Database di origine Amazon RDS e hub Amazon EC2
](#Appendix.OracleGoldenGate.rds-source-ec2-hub)
+ [

## Database di origine Amazon EC2 e hub Amazon EC2
](#Appendix.OracleGoldenGate.ec2-source-ec2-hub)
+ [

## Hub Amazon EC2 in diverse regioni AWS
](#Appendix.OracleGoldenGate.cross-region-hubs)

## Database di origine locale e hub Oracle GoldenGate
<a name="Appendix.OracleGoldenGate.on-prem-source-gg-hub"></a>

In questo scenario, un database di origine Oracle e un GoldenGate hub Oracle locale forniscono dati a un'istanza database Amazon RDS di destinazione. 

![\[GoldenGate Configurazione Oracle 0 con Amazon RDS\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/oracle-gg0.png)


## Database di origine on-premise e hub Amazon EC2
<a name="Appendix.OracleGoldenGate.on-prem-source-ec2-hub"></a>

In questo scenario, un database Oracle on-premise funge da database di origine. È connesso a un hub di istanze Amazon EC2. Questo hub fornisce i dati a un'istanza database RDS di destinazione per Oracle.

![\[GoldenGate Configurazione Oracle 1 con Amazon RDS\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/oracle-gg1.png)


## Database di origine Amazon RDS e hub Amazon EC2
<a name="Appendix.OracleGoldenGate.rds-source-ec2-hub"></a>

In questo scenario, un'istanza database RDS for Oracle funge da database di origine. È connesso a un hub di istanze Amazon EC2. Questo hub fornisce i dati a un'istanza database RDS di destinazione per Oracle.

![\[GoldenGate Configurazione Oracle 2 con Amazon RDS\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/oracle-gg2.png)


## Database di origine Amazon EC2 e hub Amazon EC2
<a name="Appendix.OracleGoldenGate.ec2-source-ec2-hub"></a>

In questo scenario, un database Oracle su un'istanza Amazon EC2 funge da database di origine. È connesso a un hub di istanze Amazon EC2. Questo hub fornisce i dati a un'istanza database RDS di destinazione per Oracle.

![\[GoldenGate Configurazione Oracle 3 con Amazon RDS\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/oracle-gg3.png)


## Hub Amazon EC2 in diverse regioni AWS
<a name="Appendix.OracleGoldenGate.cross-region-hubs"></a>

In questo scenario, un database Oracle su un'istanza database Amazon RDS è connesso a un hub di istanze Amazon EC2 nella AWS stessa regione. L'hub è connesso a un hub di istanze Amazon EC2 in una regione diversa AWS . Questo secondo hub fornisce dati all'istanza DB RDS for Oracle di destinazione nella stessa AWS regione del secondo hub di istanza Amazon EC2.

![\[GoldenGate Configurazione Oracle 4 con Amazon RDS\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/oracle-gg4.png)


**Nota**  
Tutti i problemi che influiscono sull'esecuzione di Oracle GoldenGate in un ambiente locale influiscono anche sull'esecuzione di Oracle GoldenGate su. AWS Si consiglia vivamente di monitorare l' GoldenGate hub Oracle per assicurarne `EXTRACT` il `REPLICAT` ripristino in caso di failover. Poiché l' GoldenGate hub Oracle viene eseguito su un'istanza Amazon EC2, Amazon RDS non gestisce l' GoldenGate hub Oracle e non può garantirne l'esecuzione.

# Configurazione di Oracle GoldenGate
<a name="Appendix.OracleGoldenGate.setting-up"></a>

Per configurare Oracle GoldenGate utilizzando Amazon RDS, configura l'hub su un'istanza Amazon EC2, quindi configura i database di origine e di destinazione. Le sezioni seguenti forniscono un esempio di come configurare Oracle GoldenGate per l'utilizzo con Amazon RDS for Oracle.

**Topics**
+ [

## Configurazione di un GoldenGate hub Oracle su Amazon EC2
](#Appendix.OracleGoldenGate.Hub)
+ [

## Configurazione di un database di origine da utilizzare con Oracle GoldenGate su Amazon RDS
](#Appendix.OracleGoldenGate.Source)
+ [

## Configurazione di un database di destinazione da utilizzare con Oracle GoldenGate su Amazon RDS
](#Appendix.OracleGoldenGate.Target)

## Configurazione di un GoldenGate hub Oracle su Amazon EC2
<a name="Appendix.OracleGoldenGate.Hub"></a>

Per creare un GoldenGate hub Oracle su un'istanza Amazon EC2, devi prima creare un'istanza Amazon EC2 con un'installazione client completa di Oracle RDBMS. L'istanza Amazon EC2 deve inoltre avere installato il GoldenGate software Oracle. Le versioni del GoldenGate software Oracle dipendono dalle versioni del database di origine e di destinazione. Per ulteriori informazioni sull'installazione di Oracle GoldenGate, consulta la [ GoldenGatedocumentazione Oracle](https://docs.oracle.com/en/middleware/goldengate/core/index.html).

L'istanza Amazon EC2 che funge da GoldenGate hub Oracle archivia ed elabora le informazioni sulle transazioni dal database di origine in file trail. Per supportare questo processo, assicurati che siano soddisfatti i seguenti requisiti:
+ Sia stato allocato uno spazio di archiviazione sufficiente per i file trail.
+ L'istanza Amazon EC2 abbia una capacità di calcolo sufficiente per gestire la quantità di dati.
+ Inoltre, assicurati che l'istanza EC2 disponga di memoria sufficiente per archiviare le informazioni sulle transazioni prima che vengano scritte nel file di trail.

**Per configurare un hub di architettura GoldenGate classica Oracle su un'istanza Amazon EC2**

1. Crea sottodirectory nella directory Oracle. GoldenGate 

   Nella shell della riga di comando di Amazon EC2, start`ggsci`, l'interprete dei GoldenGate comandi Oracle. Il comando `CREATE SUBDIRS` crea le sottodirectory nella directory `/gg` per i file dei parametri, dei report e dei punti di controllo.

   ```
   prompt$ cd /gg
   prompt$ ./ggsci
   
   GGSCI> CREATE SUBDIRS
   ```

1. Configura il file `mgr.prm`.

   L'esempio seguente aggiunge le righe al file `$GGHOME/dirprm/mgr.prm`.

   ```
   PORT 8199
   PurgeOldExtracts ./dirdat/*, UseCheckpoints, MINKEEPDAYS 5
   ```

1. Avvia il manager.

   L'esempio seguente avvia `ggsci` ed esegue il comando `start mgr`.

   ```
   GGSCI> start mgr
   ```

L' GoldenGate hub Oracle è ora pronto per l'uso.

## Configurazione di un database di origine da utilizzare con Oracle GoldenGate su Amazon RDS
<a name="Appendix.OracleGoldenGate.Source"></a>

Completa le seguenti attività per configurare un database di origine da utilizzare con Oracle GoldenGate.

**Topics**
+ [

### Passaggio 1: attivazione della registrazione supplementare nel database di origine
](#Appendix.OracleGoldenGate.Source.Logging)
+ [

### Passaggio 2: impostazione del parametro di inizializzazione ENABLE\$1GOLDENGATE\$1REPLICATION su true
](#Appendix.OracleGoldenGate.Source.enable-gg-rep)
+ [

### Passaggio 3: impostazione del periodo di conservazione del log nel database di origine
](#Appendix.OracleGoldenGate.Source.Retention)
+ [

### Fase 4: Creare un account GoldenGate utente Oracle nel database di origine
](#Appendix.OracleGoldenGate.Source.Account)
+ [

### Passaggio 5: concessione dei privilegi all'account utente per il database di origine
](#Appendix.OracleGoldenGate.Source.Privileges)
+ [

### Passaggio 6: aggiunta di un alias TNS per il database di origine
](#Appendix.OracleGoldenGate.Source.TNS)

### Passaggio 1: attivazione della registrazione supplementare nel database di origine
<a name="Appendix.OracleGoldenGate.Source.Logging"></a>

Per attivare la registrazione supplementare minima a livello di database, esegui la seguente procedura PL/SQL: 

```
EXEC rdsadmin.rdsadmin_util.alter_supplemental_logging(p_action => 'ADD')
```

### Passaggio 2: impostazione del parametro di inizializzazione ENABLE\$1GOLDENGATE\$1REPLICATION su true
<a name="Appendix.OracleGoldenGate.Source.enable-gg-rep"></a>

Quando imposti il parametro di inizializzazione `ENABLE_GOLDENGATE_REPLICATION` su `true`, i servizi di database supportano la replica logica. Se il database di origine si trova in un'istanza database Amazon RDS, assicurati di disporre di un gruppo di parametri assegnato all'istanza database con il parametro di inizializzazione `ENABLE_GOLDENGATE_REPLICATION` impostato su `true`. Per ulteriori informazioni sul parametro di inizializzazione `ENABLE_GOLDENGATE_REPLICATION`, consulta la [documentazione di Oracle Database](https://docs.oracle.com/en/database/oracle/oracle-database/19/refrn/ENABLE_GOLDENGATE_REPLICATION.html).

### Passaggio 3: impostazione del periodo di conservazione del log nel database di origine
<a name="Appendix.OracleGoldenGate.Source.Retention"></a>

Assicurati di configurare il database di origine in modo che mantenga i log redo archiviati. Considera le linee guida seguenti:
+ Specifica il periodo di retention dei log in ore. Il valore minimo è 1 ora.
+ Imposta la durata su un valore superiore a eventuali potenziali tempi di inattività dell'istanza database di origine e a eventuali potenziali problemi relativi al periodo di comunicazione o di rete per l'istanza di origine. Tale durata consente a Oracle di GoldenGate recuperare i log dall'istanza di origine secondo necessità.
+ Assicurarsi di disporre di spazio sufficiente sulla propria istanza per i file.

Ad esempio, impostare il periodo di conservazione per i redo log archiviati su 24 ore.

```
EXEC rdsadmin.rdsadmin_util.set_configuration('archivelog retention hours',24)
```

Se non è abilitata l'opzione di conservazione dei log o il suo valore è troppo basso, riceverai un messaggio di errore simile al seguente.

```
2022-03-06 06:17:27  ERROR   OGG-00446  error 2 (No such file or directory) 
opening redo log /rdsdbdata/db/GGTEST3_A/onlinelog/o1_mf_2_9k4bp1n6_.log for sequence 1306 
Not able to establish initial position for begin time 2022-03-06 06:16:55.
```

Poiché l'istanza database mantiene i log redo archiviati, assicurati di disporre dello spazio sufficiente per i file. Per vedere quanto spazio hai utilizzato nelle ultime *num\$1hours* ore, esegui la seguente query, sostituendola *num\$1hours* con il numero di ore.

```
SELECT SUM(BLOCKS * BLOCK_SIZE) BYTES FROM V$ARCHIVED_LOG 
   WHERE NEXT_TIME>=SYSDATE-num_hours/24 AND DEST_ID=1;
```

### Fase 4: Creare un account GoldenGate utente Oracle nel database di origine
<a name="Appendix.OracleGoldenGate.Source.Account"></a>

Oracle GoldenGate funziona come utente del database e richiede i privilegi di database appropriati per accedere ai redo log e ai redo log archiviati per il database di origine. A questo scopo, crea un account utente sul database di origine. [Per ulteriori informazioni sulle autorizzazioni per un account GoldenGate utente Oracle, consulta la documentazione Oracle.](https://docs.oracle.com/en/middleware/goldengate/core/19.1/oracle-db/establishing-oracle-goldengate-credentials.html#GUID-79122058-27B0-4FB6-B3DC-B7D1B67EB053)

Le istruzioni seguenti creano un account utente denominato `oggadm1`. 

```
CREATE TABLESPACE administrator;
CREATE USER oggadm1  IDENTIFIED BY "password"
   DEFAULT TABLESPACE ADMINISTRATOR TEMPORARY TABLESPACE TEMP;
ALTER USER oggadm1 QUOTA UNLIMITED ON administrator;
```

**Nota**  
Specifica una password diversa dal prompt mostrato qui come best practice per la sicurezza.

### Passaggio 5: concessione dei privilegi all'account utente per il database di origine
<a name="Appendix.OracleGoldenGate.Source.Privileges"></a>

In questa attività, concedi i privilegi dell'account necessari agli utenti per il database di origine.

**Per concedere privilegi dell'account per il database di origine**

1. Concedi i privilegi necessari all'account GoldenGate utente Oracle utilizzando il comando SQL `grant` e la `rdsadmin.rdsadmin_util` procedura. `grant_sys_object` Le istruzioni seguenti concedono i privilegi all'utente denominato `oggadm1`.

   ```
   GRANT CREATE SESSION, ALTER SESSION TO oggadm1;
   GRANT RESOURCE TO oggadm1;
   GRANT SELECT ANY DICTIONARY TO oggadm1;
   GRANT FLASHBACK ANY TABLE TO oggadm1;
   GRANT SELECT ANY TABLE TO oggadm1;
   GRANT SELECT_CATALOG_ROLE TO rds_master_user_name WITH ADMIN OPTION;
   EXEC rdsadmin.rdsadmin_util.grant_sys_object ('DBA_CLUSTERS', 'OGGADM1');
   GRANT EXECUTE ON DBMS_FLASHBACK TO oggadm1;
   GRANT SELECT ON SYS.V_$DATABASE TO oggadm1;
   GRANT ALTER ANY TABLE TO oggadm1;
   ```

1. Concedi i privilegi necessari a un account utente per essere amministratore Oracle GoldenGate . Esegui il seguente PL/SQL programma.

   ```
   EXEC rdsadmin.rdsadmin_dbms_goldengate_auth.grant_admin_privilege (
       grantee                 => 'OGGADM1',
       privilege_type          => 'capture',
       grant_select_privileges => true, 
       do_grants               => TRUE);
   ```

   Per revocare i privilegi, utilizzare la procedura `revoke_admin_privilege` nello stesso pacchetto.

### Passaggio 6: aggiunta di un alias TNS per il database di origine
<a name="Appendix.OracleGoldenGate.Source.TNS"></a>

Aggiungi la seguente voce `$ORACLE_HOME/network/admin/tnsnames.ora` in Oracle Home che sarà utilizzata dal processo `EXTRACT`. Per ulteriori informazioni sul file `tnsnames.ora`, consulta la [documentazione di Oracle](https://docs.oracle.com/en/database/oracle/oracle-database/19/netrf/local-naming-parameters-in-tns-ora-file.html#GUID-7F967CE5-5498-427C-9390-4A5C6767ADAA).

```
OGGSOURCE=
   (DESCRIPTION= 
        (ENABLE=BROKEN)
        (ADDRESS_LIST= 
            (ADDRESS=(PROTOCOL=TCP)(HOST=goldengate-source.abcdef12345.us-west-2.rds.amazonaws.com)(PORT=8200)))
        (CONNECT_DATA=(SERVICE_NAME=ORCL))
    )
```

## Configurazione di un database di destinazione da utilizzare con Oracle GoldenGate su Amazon RDS
<a name="Appendix.OracleGoldenGate.Target"></a>

In questo task, si configura un'istanza DB di destinazione da utilizzare con Oracle GoldenGate.

**Topics**
+ [

### Passaggio 1: impostazione del parametro di inizializzazione ENABLE\$1GOLDENGATE\$1REPLICATION su true
](#Appendix.OracleGoldenGate.Target.enable-gg-rep)
+ [

### Fase 2: Creare un account GoldenGate utente Oracle nel database di destinazione
](#Appendix.OracleGoldenGate.Target.User)
+ [

### Passaggio 3: concessione dei privilegi all'account per il database di destinazione
](#Appendix.OracleGoldenGate.Target.Privileges)
+ [

### Passaggio 4: aggiunta di un alias TNS per il database di destinazione
](#Appendix.OracleGoldenGate.Target.TNS)

### Passaggio 1: impostazione del parametro di inizializzazione ENABLE\$1GOLDENGATE\$1REPLICATION su true
<a name="Appendix.OracleGoldenGate.Target.enable-gg-rep"></a>

Quando imposti il parametro di inizializzazione `ENABLE_GOLDENGATE_REPLICATION` su `true`, i servizi di database supportano la replica logica. Se il database di origine si trova in un'istanza database Amazon RDS, assicurati di disporre di un gruppo di parametri assegnato all'istanza database con il parametro di inizializzazione `ENABLE_GOLDENGATE_REPLICATION` impostato su `true`. Per ulteriori informazioni sul parametro di inizializzazione `ENABLE_GOLDENGATE_REPLICATION`, consulta la [documentazione di Oracle Database](https://docs.oracle.com/en/database/oracle/oracle-database/19/refrn/ENABLE_GOLDENGATE_REPLICATION.html).

### Fase 2: Creare un account GoldenGate utente Oracle nel database di destinazione
<a name="Appendix.OracleGoldenGate.Target.User"></a>

Oracle GoldenGate viene eseguito come utente del database e richiede i privilegi di database appropriati. A questo scopo, crea un account utente nel database di destinazione.

L'istruzione seguente crea un utente denominato `oggadm1`.

```
CREATE TABLESPSACE administrator;
CREATE USER oggadm1  IDENTIFIED BY "password" 
   DEFAULT TABLESPACE administrator 
   TEMPORARY TABLESPACE temp;
ALTER USER oggadm1 QUOTA UNLIMITED ON administrator;
```

**Nota**  
Specifica una password diversa dal prompt mostrato qui come best practice per la sicurezza.

### Passaggio 3: concessione dei privilegi all'account per il database di destinazione
<a name="Appendix.OracleGoldenGate.Target.Privileges"></a>

In questa attività, concedi i privilegi dell'account necessari agli utenti per il database di destinazione.

**Per concedere i privilegi all'account per il database di destinazione**

1. Concedi i privilegi necessari all'account GoldenGate utente Oracle sul database di destinazione. Nell'esempio seguente vengono concessi privilegi a `oggadm1`.

   ```
   GRANT CREATE SESSION        TO oggadm1;
   GRANT ALTER SESSION         TO oggadm1;
   GRANT CREATE CLUSTER        TO oggadm1;
   GRANT CREATE INDEXTYPE      TO oggadm1;
   GRANT CREATE OPERATOR       TO oggadm1;
   GRANT CREATE PROCEDURE      TO oggadm1;
   GRANT CREATE SEQUENCE       TO oggadm1;
   GRANT CREATE TABLE          TO oggadm1;
   GRANT CREATE TRIGGER        TO oggadm1;
   GRANT CREATE TYPE           TO oggadm1;
   GRANT SELECT ANY DICTIONARY TO oggadm1;
   GRANT CREATE ANY TABLE      TO oggadm1;
   GRANT ALTER ANY TABLE       TO oggadm1;
   GRANT LOCK ANY TABLE        TO oggadm1;
   GRANT SELECT ANY TABLE      TO oggadm1;
   GRANT INSERT ANY TABLE      TO oggadm1;
   GRANT UPDATE ANY TABLE      TO oggadm1;
   GRANT DELETE ANY TABLE      TO oggadm1;
   ```

1. Concedi i privilegi necessari a un account utente per essere amministratore Oracle GoldenGate . Esegui il seguente PL/SQL programma.

   ```
   EXEC rdsadmin.rdsadmin_dbms_goldengate_auth.grant_admin_privilege (
       grantee                 => 'OGGADM1',
       privilege_type          => 'apply',
       grant_select_privileges => true, 
       do_grants               => TRUE);
   ```

   Per revocare i privilegi, utilizzare la procedura `revoke_admin_privilege` nello stesso pacchetto.

### Passaggio 4: aggiunta di un alias TNS per il database di destinazione
<a name="Appendix.OracleGoldenGate.Target.TNS"></a>

Aggiungi la seguente voce `$ORACLE_HOME/network/admin/tnsnames.ora` in Oracle Home che sarà utilizzata dal processo `REPLICAT`. Per i database Oracle multitenant, assicurati che l'alias TNS punti al nome del servizio del PDB. Per ulteriori informazioni sul file `tnsnames.ora`, consulta la [documentazione di Oracle](https://docs.oracle.com/en/database/oracle/oracle-database/19/netrf/local-naming-parameters-in-tns-ora-file.html#GUID-7F967CE5-5498-427C-9390-4A5C6767ADAA).

```
OGGTARGET=
    (DESCRIPTION= 
        (ENABLE=BROKEN)
        (ADDRESS_LIST= 
            (ADDRESS=(PROTOCOL=TCP)(HOST=goldengate-target.abcdef12345.us-west-2.rds.amazonaws.com)(PORT=8200)))
        (CONNECT_DATA=(SERVICE_NAME=ORCL))
    )
```

# Utilizzo delle utilità EXTRACT e REPLICAT di Oracle GoldenGate
<a name="Appendix.OracleGoldenGate.ExtractReplicat"></a>

Le GoldenGate utilità Oracle `EXTRACT` e Oracle `REPLICAT` collaborano per mantenere sincronizzati i database di origine e di destinazione tramite la replica incrementale delle transazioni utilizzando file trail. Tutte le modifiche che si verificano nel database di origine vengono rilevate automaticamente`EXTRACT`, quindi formattate e trasferite in file trail sull'hub di istanze Oracle GoldenGate on-premise o Amazon EC2. Dopo il completamento del carico iniziale, i dati vengono letti da questi file e replicati nel database di destinazione dall'utilità `REPLICAT`.

## Eseguire l'utilità Oracle EXTRACT GoldenGate
<a name="Appendix.OracleGoldenGate.Extract"></a>

L'utilità `EXTRACT` recupera, converte e restituisce dati dal database di origine nei file di trail. Di seguito è riportato il processo di base:

1. `EXTRACT` accoda i dettagli della transazione in memoria o nello spazio di archiviazione su disco temporaneo.

1. Il database di origine esegue il commit della transazione.

1. `EXTRACT` scrive i dettagli della transazione in un file trail.

1. Il file trail indirizza questi dettagli all'hub di istanze Oracle GoldenGate on-premise o Amazon EC2 e quindi al database di destinazione.

I passaggi seguenti avviano l'utilità `EXTRACT`, acquisiscono i dati da `EXAMPLE.TABLE` nel database di origine `OGGSOURCE` e creano i file trail. 

**Per eseguire l'utilità EXTRACT**

1. Configura il file `EXTRACT` dei parametri sull' GoldenGate hub Oracle (locale o istanza Amazon EC2). L'elenco seguente mostra un esempio di file dei parametri `EXTRACT` denominato `$GGHOME/dirprm/eabc.prm`.

   ```
   EXTRACT EABC
    
   USERID oggadm1@OGGSOURCE, PASSWORD "my-password"
   EXTTRAIL /path/to/goldengate/dirdat/ab 
    
   IGNOREREPLICATES
   GETAPPLOPS
   TRANLOGOPTIONS EXCLUDEUSER OGGADM1
   	 
   TABLE EXAMPLE.TABLE;
   ```

1. Nell' GoldenGate hub Oracle, accedi al database di origine e avvia l'interfaccia a riga di GoldenGate comando Oracle. `ggsci` L'esempio seguente mostra il formato per l'accesso.

   ```
   dblogin oggadm1@OGGSOURCE
   ```

1. Aggiungi i dati transazionali per attivare la registrazione supplementare per la tabella del database.

   ```
   add trandata EXAMPLE.TABLE
   ```

1. Utilizzando la linea di comando `ggsci`, abilita l'utilità `EXTRACT` tramite i comandi seguenti.

   ```
   add extract EABC tranlog, INTEGRATED tranlog, begin now
   add exttrail /path/to/goldengate/dirdat/ab 
      extract EABC, 
      MEGABYTES 100
   ```

1. Registra l'utilità `EXTRACT` sul database in modo che i log archiviati non vengano eliminati. Questa attività ti consente di recuperare vecchie transazioni di cui non sia stato eseguito il commit, se necessario. Per registrare l'utilità `EXTRACT` nel database, utilizza il comando seguente.

   ```
   register EXTRACT EABC, DATABASE
   ```

1. Avviare l'utilità `EXTRACT` con il comando seguente.

   ```
   start EABC
   ```

## Esecuzione dell'utilità Oracle GoldenGate REPLICAT
<a name="Appendix.OracleGoldenGate.Replicat"></a>

L'utilità `REPLICAT` immette le informazioni sulla transazione nei file di trail del database di destinazione.

I seguenti passaggi abilitano e avviano l'utilità `REPLICAT` in modo che possa replicare i dati acquisiti nella tabella `EXAMPLE.TABLE` del database di destinazione `OGGTARGET`.

**Per eseguire l'utilità REPLICATE**

1. Configura il file `REPLICAT` dei parametri sull' GoldenGate hub Oracle (locale o istanza EC2). L'elenco seguente mostra un esempio di file dei parametri `REPLICAT` denominato `$GGHOME/dirprm/rabc.prm`.

   ```
   REPLICAT RABC
    
   USERID oggadm1@OGGTARGET, password "my-password"
    
   ASSUMETARGETDEFS
   MAP EXAMPLE.TABLE, TARGET EXAMPLE.TABLE;
   ```
**Nota**  
Specifica una password diversa dal prompt mostrato qui come best practice per la sicurezza.

1. Accedi al database di destinazione e avvia l'interfaccia a riga di GoldenGate comando Oracle ()`ggsci`. L'esempio seguente mostra il formato per l'accesso.

   ```
   dblogin userid oggadm1@OGGTARGET
   ```

1. Utilizzando la linea di comando `ggsci`, aggiungi una tabella dei punti di controllo. L'utente indicato deve essere l'account GoldenGate utente Oracle, non il proprietario dello schema della tabella di destinazione. L'esempio seguente crea una tabella dei punti di controllo denominata `gg_checkpoint`.

   ```
   add checkpointtable oggadm1.oggchkpt
   ```

1. Per abilitare l'utilità `REPLICAT`, utilizza il comando seguente.

   ```
   add replicat RABC EXTTRAIL /path/to/goldengate/dirdat/ab CHECKPOINTTABLE oggadm1.oggchkpt 
   ```

1. Avvia l'utilità `REPLICAT` utilizzando il comando seguente.

   ```
   start RABC
   ```

# Monitoraggio di Oracle GoldenGate
<a name="Appendix.OracleGoldenGate.Monitoring"></a>

Quando usi Oracle GoldenGate per la replica, assicurati che il processo Oracle GoldenGate sia attivo e in esecuzione e che i database di origine e destinazione siano sincronizzati. È possibile utilizzare i seguenti strumenti di monitoraggio:
+ [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) è un servizio di monitoraggio utilizzato in questo modello per monitorare i log degli errori di GoldenGate.
+ [Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) è un servizio di notifica dei messaggi utilizzato in questo modello per inviare notifiche e-mail.

Per istruzioni dettagliate, consulta [Monitoraggio dei log di Oracle GoldenGate utilizzando Amazon CloudWatch](https://docs.aws.amazon.com/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html).

# Risoluzione dei problemi relativi a GoldenGate
<a name="Appendix.OracleGoldenGate.Troubleshooting"></a>

Questa sezione spiega i problemi più comuni relativi all'utilizzo di Oracle GoldenGate con Amazon RDS for Oracle.

**Topics**
+ [

## Errore durante l'apertura del log redo online
](#Appendix.OracleGoldenGate.Troubleshooting.Logs)
+ [

## Oracle GoldenGate sembra essere configurato correttamente ma la replica non funziona
](#Appendix.OracleGoldenGate.Troubleshooting.Replication)
+ [

## Integrated REPLICAT lento a causa della query su SYS."\$1DBA\$1APPLY\$1CDR\$1INFO"
](#Appendix.OracleGoldenGate.IR)

## Errore durante l'apertura del log redo online
<a name="Appendix.OracleGoldenGate.Troubleshooting.Logs"></a>

Assicurati di configurare i database per mantenere i log redo archiviati. Considera le linee guida seguenti:
+ Specifica il periodo di retention dei log in ore. Il valore minimo è 1 ora.
+ Imposta la durata su un valore superiore a eventuali potenziali tempi di inattività dell'istanza database di origine e a eventuali potenziali problemi relativi al periodo di comunicazione o di rete per l'istanza database di origine. Tale durata consente a Oracle di GoldenGate recuperare i log dall'istanza DB di origine in base alle esigenze.
+ Assicurarsi di disporre di spazio sufficiente sulla propria istanza per i file.

Se non è abilitata l'opzione di conservazione dei log o il suo valore è troppo basso, riceverai un messaggio di errore simile al seguente.

```
2022-03-06 06:17:27  ERROR   OGG-00446  error 2 (No such file or directory) 
opening redo log /rdsdbdata/db/GGTEST3_A/onlinelog/o1_mf_2_9k4bp1n6_.log for sequence 1306 
Not able to establish initial position for begin time 2022-03-06 06:16:55.
```

## Oracle GoldenGate sembra essere configurato correttamente ma la replica non funziona
<a name="Appendix.OracleGoldenGate.Troubleshooting.Replication"></a>

Per le tabelle preesistenti, è necessario specificare l'SCN da cui lavora GoldenGate Oracle.

**Per risolvere questo problema**

1. Accedere al database di origine e avviare l'interfaccia a riga di GoldenGate comando Oracle ()`ggsci`. L'esempio seguente mostra il formato per l'accesso.

   ```
   dblogin userid oggadm1@OGGSOURCE
   ```

1. Utilizzando la riga di comando `ggsci`, imposta l'SCN iniziale per il processo `EXTRACT`. Nell'esempio seguente, l'SCN viene impostato su 223274 per `EXTRACT`.

   ```
   ALTER EXTRACT EABC SCN 223274
   start EABC
   ```

1. Accedi al database di destinazione. L'esempio seguente mostra il formato per l'accesso.

   ```
   dblogin userid oggadm1@OGGTARGET
   ```

1. Utilizzando la riga di comando `ggsci`, imposta l'SCN iniziale per il processo `REPLICAT`. Nell'esempio seguente, l'SCN viene impostato su 223274 per `REPLICAT`.

   ```
   start RABC atcsn 223274
   ```

## Integrated REPLICAT lento a causa della query su SYS."\$1DBA\$1APPLY\$1CDR\$1INFO"
<a name="Appendix.OracleGoldenGate.IR"></a>

Oracle GoldenGate Conflict Detection and Resolution (CDR) fornisce routine di risoluzione dei conflitti di base. Ad esempio, CDR può risolvere un conflitto univoco per un'istruzione `INSERT`.

Quando CDR risolve una collisione, è possibile inserire temporaneamente record nella tabella delle eccezioni `_DBA_APPLY_CDR_INFO`. Integrato `REPLICAT` elimina questi record in un secondo momento. In uno scenario raro, `REPLICAT` integrato può elaborare un gran numero di collisioni, ma un nuovo integrato `REPLICAT` non lo sostituisce. Invece di essere rimosse, le righe esistenti in `_DBA_APPLY_CDR_INFO` sono orfane. Tutti i nuovi processi `REPLICAT` integrati rallentano perché stanno eseguendo query su righe orfane in `_DBA_APPLY_CDR_INFO`.

Per rimuovere tutte le righe da `_DBA_APPLY_CDR_INFO`, attenersi alla Amazon RDS procedura `rdsadmin.rdsadmin_util.truncate_apply$_cdr_info`. Questa procedura viene rilasciata nell'ambito della versione di ottobre 2020 e dell'aggiornamento delle patch. La procedura è disponibile nelle seguenti versioni del database:
+ [Versione 21.0.0.0.ru-2022-01.rur-2022-01.r1](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/oracle-version-21-0.html#oracle-version-RU-RUR.21.0.0.0.ru-2022-01.rur-2022-01.r1) e successive
+ [Versione 19.0.0.0.ru-2020-10.rur-2020-10.r1](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/oracle-version-19-0.html#oracle-version-RU-RUR.19.0.0.0.ru-2020-10.rur-2020-10.r1) e successive

Nell'esempio seguente viene troncata la tabella `_DBA_APPLY_CDR_INFO`.

```
SET SERVEROUTPUT ON SIZE 2000
EXEC rdsadmin.rdsadmin_util.truncate_apply$_cdr_info;
```