Configura Extract per Oracle Autonomous AI Database

Di seguito sono riportati i passi per configurare un'estrazione da acquisire da un Autonomous AI Database.

Installare Oracle GoldenGate per l'istanza di Autonomous AI Database.
Creare una distribuzione per l'ambiente Oracle GoldenGate. Questa è la distribuzione in cui verrà creata l'estrazione che acquisisce i dati dall'istanza di Autonomous AI Database. Vedere Aggiungere una distribuzione.
Ottenere le credenziali client di Autonomous AI Database.

Per stabilire la connessione all'istanza di Autonomous AI Database, scaricare il file delle credenziali client. Per scaricare le credenziali client, è possibile utilizzare Oracle Cloud Infrastructure Console o Database Actions Launchpad. Vedere Download delle credenziali client (wallet).

Nota: se non si dispone dell'accesso amministratore ad Autonomous AI Database, è necessario chiedere all'amministratore del servizio di scaricare e fornire i file delle credenziali.

Per scaricare le credenziali client, utilizzare il Pad di avvio Azioni database.

Eseguire il login all'account Autonomous AI Database.

a. Nella pagina Istanza di database fare clic su Azioni di database. Viene avviato il Launchpad di Database Actions. Launchpad tenta di eseguire il login al database come ADMIN. In caso contrario, verrà richiesto il nome utente e la password ADMIN del database.

b. Nel Launchpad Azioni database, in Amministrazione, fare clic su Scarica credenziali client (wallet).

c. Immettere una password per proteggere il file zip delle credenziali client e fare clic su Scarica.

Nota: la password fornita quando si scarica il wallet protegge il wallet delle credenziali client scaricato.

d. Salvare il file zip delle credenziali nel sistema locale.
```
The credentials `zip` file contains the following files:

- `cwallet.sso`

- `ewallet.p12`

- `keystore.jks`

- `ojdbc.properties`

- `sqlnet.ora`

- `tnsnames.ora`

- `truststore.jks`

- `ewallet.pem`

- `README.txt`
```
Fare riferimento e aggiornare (se necessario) i file sqlnet.ora e tnsnames.ora durante la configurazione di Oracle GoldenGate per l'utilizzo con l'istanza di Autonomous AI Database.

Configurare il server in cui è in esecuzione Oracle GoldenGate per connettersi all'istanza di Autonomous AI Database.

a. Eseguire il login al server in cui è stato installato Oracle GoldenGate.

b. Trasferire il file zip delle credenziali scaricato dall'istanza di Autonomous AI Database al server Oracle GoldenGate.

c. Nel server Oracle GoldenGate, estrarre il file delle credenziali in una nuova directory, ad esempio /u02/data/adwc_credentials. Questa è la directory delle chiavi.

d. Per configurare i dettagli di connessione, aprire il file tnsnames.ora dalla posizione del client Oracle nell'istanza di Oracle GoldenGate.

e. Utilizzare la stringa di connessione con il gruppo di consumer LOW dbname_low, ad esempio graphdb1_low, e spostarla nel file tnsnames.ora locale.

 The connections for the default `ggadmin` user happens only with `low`, although `high` is used in the connection string, for example `graphdb1_high`.

 See *Local Naming Parameters in the tnsnames.ora File* chapter in the *Oracle AI Database Net Services Reference* guide.

Nota:

Il file fornito con il file delle credenziali contiene tre nomi di servizio di database identificabili come:

*ADWC_Database_Name*_low

*ADWC_Database_Name*_medium

*ADWC_Database_Name*_high

Oracle consiglia di utilizzare ADWC_Database_Name_low con Oracle GoldenGate. Vedere Nomi dei servizi di database predefiniti per Autonomous AI Database nella guida Uso di Oracle Autonomous AI Database Serverless o Servizi di database predefiniti nella documentazione di Autonomous AI Database on Dedicated Exadata Infrastructure.

f. Modificare il file tnsnames.ora nell'istanza di Oracle GoldenGate per includere i dettagli di connessione disponibili nel file tnsnames.ora nella directory delle chiavi (la directory in cui è stato decompresso il file zip delle credenziali scaricato da Autonomous AI Database).

<div class="infoboxnote" markdown="1">

**Note:**
Allows connections on ports 1521 and 1522. However, the Oracle GoldenGate connection only works with the port 1522. This is mandatory. If you use 1521, you get the following error:

   <pre class="copy"><code>Login failed. OCI Error ORA (status = 24459-ORA-24459: OCISessionGet() timed out waiting for pool to create new connections\n)&quot;, &quot;code&quot;: &quot;OGG-08110&quot;</code></pre>

</div>

 <pre class="copy"><code> Sample Connection String   adw1_low. = (description=                  (retry_count=20)(retry_delay=3)                  (address=(protocol=tcps)(port=1522)(host=adb-preprod.us-phoenix-1.oraclecloud.com))                  (connect_data=(service_name=okd2ybgcz4mjx94_graphdb1_low.adb.oraclecloud.com))                  (security=(ssl_server_cert_dn=&quot;CN=adwc-preprod.uscom-east-1.oraclecloud.com,OU=Oracle BMCS US,O=Oracle Corporation,L=Redwood City,ST=California,C=US&quot;))                )</code></pre>

 If the database is within a firewall protected environment, you might not have direct access to the database. With an existing HTTP Proxy, you can pass the firewall with the following modifications to the `sqlnet.ora` and `tnsnames.ora`:

 - `sqlnet parameters`

 - `address modification of tns_alias`

 If Extract becomes unresponsive due to a network timeout or connection loss, then you can add the following into the connection profile in the `tnsnames.ora` file:

(DESCRIPTION) = (RECV_TIMEOUT=30) (ADDRESS_LIST =

      (LOAD_BALANCE=off)(FAILOVER=on)(CONNECT_TIMEOUT=3)(RETRY_COUNT=3) (ADDRESS = (PROTOCOL = TCP)(HOST = adb-preprod.us-phoenix-1.oraclecloud.com)(PORT = 1522))

g. Per configurare il wallet, creare un file sqlnet.ora nella posizione del client Oracle nell'istanza Oracle GoldenGate.

cd /u02/data/oci/network/admin
ls
sqlnet.ora tnsnames.ora

 See [Autonomous AI Database Client Credentials](/pls/topic/lookup?ctx=en/database/goldengate/core/26/coredoc&id=OGGMP-GUID-565DF23A-2E9D-4B57-B181-DC1165B31C97) in *Using Oracle GoldenGate on Oracle Cloud Marketplace*.

h. Modificare questo file sqlnet.ora per includere la directory delle chiavi.

 <pre class="copy"><code>WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY=&quot;/u02/data/adwc_credentials&quot;))) SSL_SERVER_DN_MATCH=yes</code></pre>

Utilizzare il client di amministrazione per eseguire il login alla distribuzione di Oracle GoldenGate, a seconda che si utilizzino i microservizi.
Creare una credenziale per memorizzare l'utente e la password GGADMIN. Questo utente verrà utilizzato per connettersi ad Autonomous AI Database dalla riga di comando, per eseguire comandi che richiedono una connessione al database. Verrà utilizzato anche nel parametro USERIDALIAS per la connessione al database Extract.
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_low PASSWORD complex_password alias adb_alias
```
È anche possibile utilizzare il seguente comando con high nella stringa di connessione, ma continuerà a connettersi con low:
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_high PASSWORD complex_password alias adb_alias
```
Connettersi al database utilizzando DBLOGIN. L'utente DBLOGIN deve essere l'utente dell'account adb_alias.
```
 DBLOGIN USERIDALIAS adb_alias
```
Configurare il log supplementare sulle tabelle che si desidera acquisire utilizzando ADD TRANDATA o ADD SCHEMATRANDATA. Tenere presente che si è connessi direttamente all'istanza di database, pertanto non è necessario includere il nome del database in questi comandi. Ecco un'exmaple:
```
 ADD TRANDATA HR.EMP
```
oppure
```
 ADD SCHEMATRANDATA HR
```

Vedere Abilita log supplementare minimo in Oracle Autonomous AI Database per Oracle GoldenGate Extract.

Aggiungere la tabella heartbeat.
```
 ADD HEARTBEATTABLE
```
Aggiungere e configurare un Extract da acquisire dall'istanza di Autonomous AI Database. Vedere Aggiungi un'estrazione per i passi necessari per creare un'estrazione.

Oracle GoldenGate Extract è progettato per funzionare con l'istanza di Autonomous AI Database per garantire che acquisisca solo da un'istanza di database specifica. Ciò significa che il nome dell'istanza di database non è necessario per alcuna istruzione TABLE o MAP.

Nell'esempio riportato di seguito viene creato un Extract (obbligatorio per l'acquisizione da un Autonomous AI Database) denominato exte e viene indicato che deve iniziare ora.

<pre class="copy"><code>ADD EXTRACT exte, INTEGRATED TRANLOG, BEGIN NOW</code></pre>

Per acquisire tabelle specifiche, utilizzare i nomi degli oggetti delle due parti. Ad esempio, per acquisire dalla tabella HR.EMP nell'istanza di Autonomous AI Database, utilizzare questa voce nel file dei parametri Extract.

<pre class="copy"><code> TABLE HR.EMP;</code></pre>

Se si desidera replicare HR.EMP in COUNTRY.EMPLOYEE, l'istruzione mappa sarà simile alla seguente:

<pre class="copy"><code> MAP HR.EMP, TARGET COUNTRY.EMPLOYEE;</code></pre>

Registra Extract con l'istanza di Autonomous AI Database. Ad esempio, per registrare un Extract denominato exte, utilizzare il comando seguente:
```
 REGISTER EXTRACT exte DATABASE
```
Ora è possibile avviare Extract ed eseguire la replica dei dati nell'istanza di Autonomous AI Database. Di seguito viene fornito un esempio.
```
 START EXTRACT exte
```
Questo completa il processo di configurazione di Extract per Autonomous AI Database ed è possibile utilizzarlo come qualsiasi altro processo Extract.