Configurar Extract para Oracle Autonomous AI Database

A continuación, se muestran los pasos para configurar un Extract para capturar desde una instancia de Autonomous AI Database:

Instale Oracle GoldenGate para su instancia de Autonomous AI Database.
Cree un despliegue para el entorno de Oracle GoldenGate. Este es el despliegue en el que se creará la extracción que captura datos de la instancia de Autonomous AI Database. Consulte Agregar un despliegue.
Obtener credenciales de cliente de Autonomous AI Database.

Para establecer una conexión a la instancia de Autonomous AI Database, descargue el archivo de credenciales de cliente. Para descargar credenciales de cliente, puede utilizar Oracle Cloud Infrastructure Console o la pantalla de inicio de Database Actions. Consulte Descarga de credenciales de cliente (carteras).

Nota: Si no tiene acceso de administrador a Autonomous AI Database, debe solicitar al administrador del servicio que descargue y le proporcione los archivos de credenciales.

Los siguientes pasos utilizan la Lanzadora de inicio de Database Actions para descargar las credenciales del cliente.

Conéctese a su cuenta de Autonomous AI Database.

a. En la página Instancia de base de datos, haga clic en Acciones de base de datos. Esto inicia el Launchpad de Database Actions. Launchpad intenta conectarse a la base de datos como ADMIN. Si no se realiza correctamente, se le solicitará el nombre de usuario y la contraseña de ADMIN de la base de datos.

b. En la pantalla de inicio de Database Actions, en Administración, haga clic en Descargar credenciales de cliente (carteras).

c. Introduzca una contraseña para proteger el archivo zip de credenciales de cliente y haga clic en Descargar.

Nota: La contraseña que proporciona al descargar la cartera protege la cartera de credenciales de cliente descargada.

d. Guarde el archivo zip de credenciales en el sistema local.
```
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`
```
Consulte y actualice (si es necesario) los archivos sqlnet.ora y tnsnames.ora al configurar Oracle GoldenGate para que funcione con la instancia de Autonomous AI Database.

Configure el servidor en el que se ejecuta Oracle GoldenGate para conectarse a la instancia de Autonomous AI Database.

a. Conéctese al servidor en el que se instaló Oracle GoldenGate.

b. Transfiera el archivo zip de credenciales que ha descargado de la instancia de Autonomous AI Database al servidor de Oracle GoldenGate.

c. En el servidor de Oracle GoldenGate, descomprima el archivo de credenciales en un nuevo directorio, por ejemplo: /u02/data/adwc_credentials. Este es su directorio clave.

d. Para configurar los detalles de conexión, abra el archivo tnsnames.ora desde la ubicación del cliente de Oracle en la instancia de Oracle GoldenGate.

e. Utilice la cadena de conexión con el grupo de consumidores LOW dbname_low, por ejemplo, graphdb1_low, y muévala al archivo tnsnames.ora local.

 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:

El archivo proporcionado con el archivo de credenciales contiene tres nombres de servicio de base de datos identificables como:

*ADWC_Database_Name*_low

*ADWC_Database_Name*_medium

*ADWC_Database_Name*_high

Oracle recomienda utilizar ADWC_Database_Name_low con Oracle GoldenGate. Consulte Nombres de servicio de base de datos predefinidos para Autonomous AI Database en la guía Uso de Oracle Autonomous AI Database Serverless o Servicios de base de datos predefinidos en la documentación de Autonomous AI Database en infraestructura de Exadata dedicada.

f. Edite el archivo tnsnames.ora en la instancia de Oracle GoldenGate para incluir los detalles de conexión disponibles en el archivo tnsnames.ora en el directorio de claves (el directorio en el que ha descomprimido el archivo zip de credenciales descargado de 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. Para configurar la cartera, cree un archivo sqlnet.ora en la ubicación del cliente de Oracle en la instancia de 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. Edite este archivo sqlnet.ora para incluir el directorio de claves.

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

Utilice el cliente de administración para conectarse al despliegue de Oracle GoldenGate, en función de si utiliza microservicios.
Cree una credencial para almacenar el usuario y la contraseña GGADMIN. Este usuario se utilizará para conectarse a Autonomous AI Database desde la línea de comandos, para realizar comandos que requieren una conexión a la base de datos. También se utilizará en el parámetro USERIDALIAS para la conexión a la base de datos de Extract.
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_low PASSWORD complex_password alias adb_alias
```
También puede utilizar el siguiente comando con high en la cadena de conexión, pero aún se conectará con low:
```
 ALTER CREDENTIALSTORE ADD USER
 ggadmin@dbgraph1_high PASSWORD complex_password alias adb_alias
```
Conéctese a la base de datos mediante DBLOGIN. El usuario DBLOGIN debe ser el usuario de cuenta adb_alias.
```
 DBLOGIN USERIDALIAS adb_alias
```
Configure el registro complementario en las tablas, que desea capturar mediante ADD TRANDATA o ADD SCHEMATRANDATA. Recuerde que está conectado directamente a la instancia de base de datos, por lo que no es necesario incluir el nombre de la base de datos en estos comandos. Aquí hay un ejemplo:
```
 ADD TRANDATA HR.EMP
```
o bien
```
 ADD SCHEMATRANDATA HR
```

Consulte Activación de registro complementario mínimo en Oracle Autonomous AI Database for Oracle GoldenGate Extract.

Agregue la tabla de latidos.
```
 ADD HEARTBEATTABLE
```
Agregue y configure un Extract para capturarlo desde la instancia de Autonomous AI Database. Consulte Adición de un Extract para conocer los pasos para crear un Extract.

Oracle GoldenGate Extract está diseñado para trabajar con la instancia de Autonomous AI Database a fin de garantizar que solo captura desde una instancia de base de datos específica. Esto significa que el nombre de la instancia de base de datos no es necesario para ninguna sentencia TABLE o MAP.

En el siguiente ejemplo se crea un Extract (necesario para la captura desde una instancia de Autonomous AI Database) denominado exte y se le indica que empiece ahora.

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

Para capturar tablas específicas, utilice los dos nombres de objeto de parte. Por ejemplo, para capturar desde la tabla HR.EMP, en la instancia de Autonomous AI Database, utilice esta entrada en el archivo de parámetros Extract.

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

Si desea replicar HR.EMP en COUNTRY.EMPLOYEE, la sentencia map tendría el siguiente aspecto:

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

Registre Extract con la instancia de Autonomous AI Database. Por ejemplo, para registrar un Extract denominado exte, utilice el siguiente comando:
```
 REGISTER EXTRACT exte DATABASE
```
Ahora puede iniciar Extract y realizar la replicación de datos en la instancia de Autonomous AI Database. Tomemos el siguiente ejemplo:
```
 START EXTRACT exte
```
De esta forma se completa el proceso de configuración de un Extract para Autonomous AI Database y puede utilizarlo como cualquier otro proceso de Extract.