Replicación de los datos de PostgreSQL al procesamiento de transacciones de IA autónoma

Descubra cómo replicar datos de una base de datos del servidor PostgreSQL en Autonomous AI Transaction Processing mediante OCI GoldenGate.

Antes de empezar

Para completar correctamente este inicio rápido, debe tener lo siguiente:

Una instalación de PostgreSQL para servir como base de datos de origen (consulte Configuración del entorno)
Abra el puerto 5432 en la lista de seguridad de la VCN
Una instancia de procesamiento de transacciones de IA autónoma que sirva como base de datos de destino

Configuración del entorno: PostgreSQL

Para configurar el entorno para este inicio rápido:

Ejecute los siguientes comandos para instalar PostgreSQL.
1. Instale el servidor PostgreSQL:
```
sudo yum install postgresql-server
```
2. Instale el módulo postgresql-contrib para evitar esta excepción SQL:
```
sudo yum install postgresql-contrib
```
3. Cree un nuevo cluster de base de datos PostgreSQL:
```
sudo postgresql-setup --initdb
```
4. Active postgresql.service:
```
sudo systemctl enable postgresql.service
```
5. Inicie postgresql.service:
```
sudo systemctl start postgresql.service
```
Por defecto, PostgreSQL solo permite conexiones locales. Permitir conectividad remota a PostgreSQL.
1. En /var/lib/pgsql/data/postgresql.conf, prepare la base de datos para la replicación.
2. Localice y quite el comentario de listen_addresses = 'localhost' y cambie localhost a un asterisco ("):
```
listen_addresses = '*'
```
3. Defina los siguientes parámetros de la siguiente manera:
  - wal_level = logical
  - max_replication_slots = 1
  - max_wal_senders = 1
  - track_commit_timestamp = on
  Nota:
  
  Configure /var/lib/pgsql/data/pg_hba.conf para asegurarse de que la autenticación de cliente está definida para permitir conexiones desde un host de Oracle GoldenGate. Por ejemplo, agregue lo siguiente:
```
#Allow connections from remote hosts

host all all 0.0.0.0/0 md5
```
  Consulte The pg_hba.conf File para obtener más información.
  1. Reinicie el servidor de PostgreSQL:
```
sudo systemctl restart postgresql.service
```
  1. Si utiliza Oracle Cloud Compute para alojar PostgreSQL, abra el puerto 5432:
```
sudo firewall-cmd --permanent --add-port=5432/tcp
sudo firewall-cmd --reload
sudo firewall-cmd --list-all
```
4. Abra el puerto 5432 en la lista de seguridad de la VCN.
5. Conéctese a PostgreSQL.
```
> sudo su - postgres
> psql
```
  Nota: También puede introducir sudo su - postgres psql si el ejemplo anterior no funciona.
6. Definición de PostgreSQL.
  1. Descargue y ejecute seedSRCOCIGGLL_PostgreSQL.sql para configurar la base de datos y cargar los datos de ejemplo.
  2. Ejecute los siguientes comandos para configurar el usuario (asegúrese de sustituir <password> por una contraseña real):
```
create user ggadmin with password '<password>';
alter user ggadmin with SUPERUSER;
GRANT ALL PRIVILEGES ON DATABASE ociggll TO ggadmin;
```

Configuración del entorno: procesamiento de transacciones de IA autónoma (ATP)

Descargue y descomprima el esquema de base de datos de ejemplo.
Desbloquee el usuario de GGADMIN.
1. En la consola de Oracle Cloud, seleccione su instancia de ATP en la página Bases de datos de IA autónomas para ver los detalles y acceder a Database Actions.
2. Seleccione Database Actions y, a continuación, Database Users.
3. Localice GGADMIN y, a continuación, seleccione el menú de puntos suspensivos (tres puntos) y seleccione Editar.
4. En el panel Editar usuario, introduzca la contraseña de GGADMIN, confirme la contraseña y, a continuación, anule la selección de Cuenta bloqueada.
5. Seleccione Apply Changes (Aplicar cambios).
Cargue los datos y el esquema de ejemplo de destino.
1. En el menú Database Actions, seleccione SQL.
2. Copie y pegue el script de OCIGGLL_OCIGGS_SETUP_USERS_ADW.sql en la hoja de Trabajo de SQL.
3. Seleccione Run Script. El separador Salida de script mostrará los mensajes de confirmación.
4. Borre la hoja de trabajo SQL y, por último, copie y pegue el SQL de OCIGGLL_OCIGGS_SRC_MIRROR_USER_SEED_DATA.sql.
5. Para verificar que las tablas se han creado correctamente, cierre la ventana SQL y vuelva a abrirla. En el separador Navegador, busque el esquema SRC_OCIGGLL y, a continuación, seleccione las tablas en sus respectivas listas desplegables.

Tarea 1: Creación de recursos de OCI GoldenGate

En este ejemplo de inicio rápido se necesitan despliegues y conexiones tanto para el origen como para el destino.

Cree un despliegue para la base de datos PostgreSQL de origen.
Cree un despliegue para la instancia de procesamiento de transacciones de IA autónoma de destino.
Cree una conexión a la base de datos PostgreSQL de origen.
1. Para Tipo, asegúrese de seleccionar Servidor PostgreSQL.
2. En Nombre de base de datos, introduzca ociggll.
3. En Host, introduzca la IP pública de la instancia informática en la que se ejecuta PostgreSQL.
4. En Puerto, introduzca 5432.
5. En Nombre de usuario, introduzca ggadmin.
6. En Contraseña, introduzca una contraseña.
7. En Protocolo de seguridad, seleccione Plain.
Crear conexión para la instancia de procesamiento de transacciones de IA autónoma de destino.
Cree una conexión a GoldenGate y, a continuación, asigne esta conexión al despliegue de PostgreSQL de origen.
Asigne la conexión de origen al despliegue de PostgreSQL de destino.
Asigne la conexión de destino al despliegue de destino de Oracle.

Tarea 2: Activar el registro complementario

Para activar el registro complementario:

Inicie la consola de despliegue de PostgreSQL GoldenGate:
1. En la página Despliegues, seleccione el despliegue de PostgreSQL para ver los detalles.
2. En la página del despliegue de PostgreSQL, seleccione Iniciar consola.
3. En la página de conexión de la consola de despliegue, introduzca las credenciales de administrador de GoldenGate proporcionadas en la tarea 1, paso 1.
  
  Nota: La conexión es necesaria si IAM no se ha seleccionado como almacén de credenciales al crear un despliegue.
En la consola de despliegue, seleccione Conexiones de base de datos en la navegación izquierda, la base de datos PostgreSQL de origen y, a continuación, Trandata.
En la página Datos de Transacción, junto a Información de TRANDATA, seleccione Agregar Datos de Transacción (icono más).
En el panel Datos de transacción, en Nombre de esquema, introduzca src_ociggll y, a continuación, seleccione Enviar.

Nota: Utilice el campo de búsqueda para buscar src_ociggll y verificar que se han agregado las tablas.

Tarea 3: Creación de los Extracts

Agregue la extracción de captura de datos del cambio:
1. En la navegación izquierda, seleccione Extracts.
2. En la página Extracts, seleccione Add Extract (icono más) y, a continuación, complete los campos de la siguiente manera:
  - En la página Información de extracción:
    1. En Tipo de extracción, seleccione Cambiar extracción de captura de datos.
    2. En Nombre de proceso, introduzca un nombre para el Extract, como ECDC.
    3. Seleccione Next (Siguiente).
  - En la página Opciones de Extracción:
    1. Para las credenciales de origen, seleccione Oracle GoldenGate en la lista desplegable Dominio
    2. Seleccione la base de datos PostgreSQL de origen en la lista desplegable Alias.
    3. En Nombre de pista de extracción, introduzca un nombre de pista de dos caracteres, como C1.
    4. Seleccione Next (Siguiente).
  - En la página Parámetros de Extract, sustituya MAP *.*, TARGET *.*; por lo siguiente:
```
TABLE SRC_OCIGGLL.*;
```
3. Seleccione Crear y ejecutar.
Agregue el Extract de carga inicial:
1. En la página Extracts, seleccione Agregar Extract y, a continuación, complete el formulario Add Extract de la siguiente manera:
  - En la página Información de extracción:
    1. Para el tipo de extracción, seleccione Extracción de carga inicial.
    2. En Nombre de proceso, introduzca un nombre, como EIL.
    3. Seleccione Next (Siguiente).
  - En la página Opciones de Extracción:
    1. Para las credenciales de origen, seleccione Oracle GoldenGate en la lista desplegable Dominio.
    2. Seleccione la base de datos PostgreSQL en la lista desplegable Alias.
    3. En Nombre de Pista de Extracción, introduzca un nombre de ruta de dos caracteres, como I1.
    4. Seleccione Next (Siguiente).
  - En la página Parámetros de Extract, sustituya el contenido del área de texto por lo siguiente:
```
EXTRACT EIL
USERIDALIAS PostgreSQL_Compute, DOMAIN OracleGoldenGate
EXTFILE I1, PURGE
TABLE src_ociggll.*;
```
    Nota: Asegúrese de eliminar el parámetro SOURCEDB delante de USERIDALIAS antes de continuar.
2. Seleccione Crear y ejecutar.

Vuelva a la página Extracts, donde puede observar el inicio de Extract.

Tarea 4: Creación de la ruta de distribución para el Extract de carga inicial

En la página Despliegues, seleccione el despliegue de Oracle de destino.
En la página de detalles del despliegue, seleccione Iniciar consola y, a continuación, conéctese como usuario administrador.
Si utiliza el almacén de credenciales de IAM, continúe con el paso Crear una ruta de distribución. Si utiliza el almacén de credenciales de GoldenGate, cree un usuario con el que GoldenGate de origen utilice para conectarse al GoldenGate de destino.
1. En el menú de navegación, seleccione User Administration (Administración de usuarios).
2. Seleccione Agregar nuevo usuario (icono con signo más), complete los campos como se indica a continuación y, a continuación, seleccione Enviar:
  - En Nombre de usuario, introduzca ggsnet.
  - En Rol, seleccione Operador.
  - Introduzca la contraseña dos veces para su verificación.
En la consola de despliegue de PostgreSQL de origen, cree una conexión de ruta para el usuario creado en el paso anterior.
1. En el menú de navegación, seleccione Path Connections (Conexiones de ruta).
2. Seleccione Agregar conexión de ruta de acceso (icono más), complete los campos de la siguiente manera y, a continuación, seleccione Enviar:
  - En Alias de credencial, introduzca dpuser.
  - En ID de usuario, introduzca ggsnet
  - En Contraseña, introduzca la misma contraseña utilizada en el paso anterior.
Crear una ruta de distribución.
1. En la barra de menús del servicio, seleccione Rutas y, a continuación, seleccione Agregar ruta de distribución (icono más).
2. Complete el formulario Agregar ruta de la siguiente manera:
  - En la página Path Information:
    1. En Nombre de la ruta, introduzca un nombre para esta ruta.
    2. Seleccione Next (Siguiente).
  - En la página Source Options:
    1. En Extracción de origen, deje en blanco.
    2. En Nombre de pista, introduzca el nombre de pista de Extract de carga inicial (I1).
    3. Seleccione Next (Siguiente).
  - En la página Opciones de Destino:
    1. En Destino, seleccione wss.
    2. En Host de Destino, introduzca la URL de despliegue de origen, sin https:// ni barras inclinadas finales.
    3. En Número de puerto, introduzca 443.
    4. En Nombre de la pista, introduzca I1.
    5. En Método de autenticación del destino, seleccione Alias de ID de Usuario.
    6. En Dominio, introduzca el nombre de dominio creado en el paso anterior.
    7. En Alias, introduzca el alias creado en el paso anterior (dpuser).
    8. Seleccione Next (Siguiente).
3. Seleccione Crear y ejecutar.
Volverá a la página Servicio de distribución, donde podrá revisar la ruta de acceso creada.
En la consola de despliegue de destino, revise la ruta del receptor creada como resultado de la ruta del distribuidor:
1. Seleccione Paths (Rutas).
2. Revise los detalles de ruta.

Tarea 5: Adición de un Replicat para la carga inicial

En el despliegue de Oracle de destino, agregue una tabla de puntos de control.
1. En el menú de navegación, seleccione Conexiones de Base de Datos
2. Seleccione la instancia de base de datos de IA autónoma de destino y, a continuación, Puntos de control.
3. En la página Puntos de Control, seleccione Agregar Punto de Control (icono más).
4. En el panel Punto de control, para Tabla de esquema, introduzca SRCMIRROR_OCIGGLL.CHECKTABLE.
5. Seleccione Enviar.
Agregue el Replicat.
1. En el menú de navegación, seleccione Replicats.
2. En la página Replicats, seleccione Agregar Replicat (icono más) y, a continuación, complete los campos Add Replicat de la siguiente manera:
  - En la página Replicat Information:
    1. En Tipo de replicación, seleccione Replicato no integrado.
    2. En Nombre de proceso, introduzca un nombre, como RIL.
    3. Seleccione Siguiente.
  - En la página Replicat Options:
    1. En Nombre de Pista de Replicat, introduzca el nombre de las pistas desde la tarea 2 (I1).
    2. En Credenciales de destino, seleccione el dominio y el alias para la conexión a la base de datos de IA autónoma.
    3. En Tabla de puntos de Control, seleccione la tabla que ha creado en el paso 1.
    4. Seleccione Next (Siguiente).
  - En la página Archivo de Parámetros, sustituya MAP *.*, TARGET *.*; por lo siguiente:
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
3. Seleccione Crear y ejecutar.
Volverá a la página Replicats, donde podrá revisar los detalles de Replicat.
Seleccione el Replicat (RIL) y vea los Detalles.
Seleccione Estadísticas y revise el número de inserciones. Refresque la página.
- Si el número de inserciones no cambia, significa que se han cargado todos las historias clínicas de la carga inicial y que puede parar el Replicat (RIL)
- Si el número de inserciones continúa aumentando, siga refrescando la página hasta que todos los registros de la carga inicial se hayan cargado antes de continuar.
Verificación de la carga Inicial.
1. En la consola de Oracle Cloud, en la página de detalles de base de datos de IA autónoma, seleccione Acciones de base de datos y, a continuación, seleccione SQL.
2. En la herramienta SQL, introduzca cada una de las siguientes sentencias en la hoja, y seleccione Ejecutar sentencia:
```
SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CITY;
SELECT * FROM SRCMIRROR_OCIGGLL.SRC_CUSTOMER;
```
  La salida debe devolver los datos que se han cargado en las tablas de la base de datos de destino como resultado de la carga inicial.

Tarea 6: Crear una ruta de distribución para la captura de cambios en los datos

En la consola de despliegue de PostgreSQL de origen, seleccione Servicio de distribución.
Seleccione Agregar ruta de distribución.
Complete el formulario Agregar ruta de la siguiente manera:
1. En la página Path Information:
  1. En Nombre de ruta, introduzca un nombre.
  2. Seleccione Next (Siguiente).
2. En la página Source Options:
  1. En Extracción de origen, seleccione la extracción de captura de datos de cambio (ECDC).
  2. En Nombre de la pista, seleccione el archivo del registro de captura del cambio de datos (C1).
  3. Seleccione Next (Siguiente).
3. En la página Opciones de Destino:
  1. En Destino, seleccione wss.
  2. En Host de destino, introduzca la URL de la consola de despliegue de destino (puede encontrarlo en la página de detalles del despliegue, sin https:// ni barras finales).
  3. En Número de puerto, introduzca 443.
  4. En Nombre de la pista, introduzca C1.
  5. En Método de autenticación del destino, seleccione Alias de ID de Usuario.
  6. En Dominio, introduzca el nombre de dominio.
  7. En Alias, introduzca el alias.
4. Seleccione Create Path and Run.
En la consola de despliegue de Oracle de destino, seleccione Servicio de receptor y, a continuación, revise la ruta de receptor creada.

Tarea 7: Adición de un Replicat para la captura de cambios en los datos

En la consola de despliegue de Oracle de destino, agregue un Replicat.
1. En el menú de navegación Administration Service, seleccione Replicats.
2. En la página Replicats, seleccione Add Replicat (icono más) y, a continuación, complete el formulario Add Replicat de la siguiente forma:
  - En la página Replicat Information:
    1. En Tipo de replicación, seleccione Replicato no integrado.
    2. En Nombre de proceso, introduzca un nombre, como RCDC.
    3. Seleccione Next (Siguiente).
  - En la página Replicat Options:
    1. En Nombre de Pista de Replicat, introduzca el nombre de las pistas desde la tarea 3 (C1).
    2. En Credenciales de destino, seleccione el dominio y el alias para la conexión a la base de datos de IA autónoma.
    3. En Tabla de puntos de control, seleccione la tabla de puntos de control.
  - En la página Parámetros de Replicat, sustituya MAP *.*, TARGET *.*; por la siguiente asignación:
```
MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;
```
3. Seleccione Crear. No ejecute el Replicat.
En la página Replicats, seleccione el Replicat de Carga Inicial (RIL) y vea los Detalles.
Seleccione Estadísticas y revise el número de inserciones. Refresque la página.
- Si el número de inserciones no cambia, quiere decir que se han cargado todos los registros de la carga inicial y que puede parar el Replicat (RIL).
- Si el número de inserciones continúa aumentando, siga refrescando la página hasta la carga de los registros iniciales se hayan cargado antes que continuar.
  
  Nota: Si no ve ninguna inserción, seleccione Servicio de métricas de rendimiento, seleccione Extraer y, a continuación, seleccione Estadísticas de base de datos.
Vuelva a la página Replicats y, a continuación, inicie Replicat para captura de cambios en los Datos (RCDC).
Luego de iniciar el Replicat para cambiar la captura de datos, revise sus Detalles y Estadísticas para ver el número de inserciones.

Verificar replicación:

Ejecute el siguiente script para realizar inserciones en la base de datos 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);

En la consola de despliegue de PostgreSQL de origen, seleccione Change Data Capture Extract (ECDC) y, a continuación, seleccione Estadísticas. Verifique que src_ocigll.src_city tenga 10 inserciones.

Nota: Si el Extract no capturó ninguna inserción, reinicie el Extract ECDC.
En la consola de despliegue de Oracle de destino, seleccione el nombre de Replicat (RCDC), visualice sus detalles y, a continuación, marque Estadísticas. Verifique que SRCMIRROR_OCIGGLL.SRC_CITY tenga 10 inserciones.