Replicación de datos de Autonomous Transaction Processing en OCI Object Storage

Antes de empezar

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

Una clave de API creada y descargada desde la página de detalles del usuario
Una instancia de Autonomous Transaction Processing de origen
El OCID de su compartimento

Configuración de entorno: Autonomous Transaction Processing

Si aún no tiene una base de datos de origen configurada para la replicación, puede seguir estos pasos para cargar un esquema de ejemplo que utilizar para este inicio rápido. Este inicio rápido utiliza Autonomous Transaction Processing para la base de datos de origen.

Para configurar la instancia de Autonomous Database de origen:

Descargue y descomprima el esquema de base de datos de ejemplo.
En la consola de Oracle Cloud, seleccione la instancia de Autonomous Transaction Processing (ATP) en la página Bases de datos autónomas para ver los detalles y acceder a Database Actions.
Desbloquee el usuario GGADMIN:
1. Haga clic en Acciones de la base de datos y, a continuación, en Usuarios de la base de datos.
2. Busque GGADMIN y, a continuación, haga clic en el menú de puntos suspensivos (tres puntos) y seleccione Editar.
3. En el panel Edit User, introduzca la contraseña de GGADMIN, confirme la contraseña y, a continuación, anule la selección de Account is Locked.
4. Haga clic en Aplicar cambios.
Cargue el esquema y los datos de ejemplo de origen:
1. En el menú Acciones de base de datos, en Desarrollo, seleccione SQL.
2. Copie y pegue el script de OCIGGLL_OCIGGS_SETUP_USERS_ATP.sql en la hoja de trabajo de SQL.
3. Haga clic en Ejecutar script. El separador Salida de script mostrará los mensajes de confirmación.
4. Borrar la hoja de trabajo de SQL y, a continuación, copiar y pegar el script SQL de OCIGGLL_OCIGGS_SRC_USER_SEED_DATA.sql.
  
  Sugerencia:
  Puede que necesite ejecutar cada sentencia por separado para que la herramienta SQL ejecute los scripts correctamente.
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.
Active el registro complementario:
1. Borre la hoja de trabajo de SQL.
2. Introduzca la siguiente sentencia y, a continuación, haga clic en Ejecutar sentencia:
```
ALTER PLUGGABLE DATABASE ADD SUPPLEMENTAL LOG DATA;
```

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 de Oracle para la instancia de Autonomous Transaction Processing de origen.
Cree un despliegue de Big Data para el cubo de OCI Object Storage de destino.
Cree una conexión para la instancia de Autonomous Transaction Processing de origen.
Cree una conexión para OCI Object Storage de destino.
Cree una conexión a GoldenGate y, a continuación, asigne esta conexión al despliegue de Oracle de origen.
Asigne la conexión de Autonomous Transaction Processing al despliegue de Oracle de origen.
Asigne la conexión de OCI Object Storage al despliegue de Big Data de destino.

Tarea 2: Adición de Extract

En la página Despliegues, seleccione el despliegue de Autonomous Transaction Processing de origen.
En la página de detalles del despliegue, haga clic en Iniciar consola.
Conéctese con el nombre de usuario y la contraseña del administrador del despliegue de origen.
Agregue la información de transacción.
Agregue un Extract.

Tarea 3: Adición y ejecución de Distribution Path

Si utiliza el almacén de credenciales GoldenGate, cree un usuario para la ruta de distribución en el despliegue de Big Data de destino; de lo contrario, vaya al paso 3.
En la consola de despliegue de ATP de origen GoldenGate, agregue una conexión de ruta para el usuario creado en el paso 1.
1. En la consola de despliegue ATP de origen GoldenGate, haga clic en Conexiones de ruta en la navegación izquierda.
2. Haga clic en Agregar conexión de ruta (icono más) y, a continuación, complete lo siguiente:
  1. En Alias de credencial, introduzca GGSNetwork.
  2. En ID de usuario, introduzca el nombre del usuario creado en el paso 1.
  3. Introduzca la contraseña del usuario dos veces para su verificación.
3. Haga clic en Enviar.
  
  La conexión de ruta aparece en la lista Conexiones de ruta.
En la consola de despliegue de ATP de origen, agregue una ruta de distribución con los siguientes valores:
1. En la página Opciones de origen:
  - En Extract de origen, seleccione el Extract creado en la tarea 2.
  - En Nombre de pista, introduzca un nombre de dos caracteres, como E1.
2. En la página Opciones de destino:
  - En Host de destino, introduzca el dominio de host del despliegue de destino.
  - En Número de puerto, introduzca 443.
  - En Nombre de pista, introduzca un nombre de dos caracteres, como E1.
  - En Alias, introduzca el alias de credencial creado en el paso 2.
En la consola de despliegue de Big Data de destino, revise la Receiver Path creada como resultado de Distribution Path.
1. En la consola de despliegue de Big Data de destino, haga clic en Receiver Service.
2. Revise los detalles de la ruta. Esta ruta se ha creado como resultado de la creación de Distribution Path en el paso anterior.

Tarea 4: Adición y ejecución del Replicat

En el menú de navegación de la consola de despliegue de Big Data de destino, haga clic en Replicats.
En la página Replicats, haga clic en Agregar Replicat (icono más) y, a continuación, complete el formulario de la siguiente manera:
1. En la página Información de Replicat:
  1. En Tipo Replicat, seleccione Clásico Replicat.
  2. En Nombre de proceso, introduzca un nombre, como REP
2. En la página Opciones de Replicat:
  1. En Replicat Nombre de pista, introduzca un nombre de dos caracteres, como E1.
  2. En Destino, seleccione OCI Object Storage
3. En la página Archivo de parámetros, sustituya MAP *.*, TARGET *.*; por:
```
MAP SRC_OCIGGLL.*, TARGET *.*;
```
4. En la página Archivo de propiedades, configure las propiedades del manejador de eventos de OCI según sea necesario.
  Propiedades necesarias:
  - gg.eventhandler.oci.compartmentID: OCID del compartimento en el que reside el cubo de OCI Object Storage.
  - gg.handler.oci.fileNameMappingTemplate: genera nombres de archivos de forma dinámica mediante Palabras clave de plantilla.
  Las propiedades cuya modificación puede considerar:
  - gg.handler.oci.format: seleccione cómo aplicar formato a la salida. json_row es el valor por defecto. Las opciones disponibles son:
    
    delimitedtext
    
    json
    
    json_row
    
    xml
    
    avro_row_ocf
    
    avro_op_ocf
    
    Sugerencia:
    Para utilizar la propiedad de formato para OCI Object Storage, sustituya name por oci. Por ejemplo, gg.handler.name.format se convierte en gg.handler.oci.format.
  - gg.handler.oci.inactivityRollInterval: GoldenGate crea un archivo y lo mantiene abierto para la escritura. Esta propiedad cierra el archivo después del período de inactividad designado (sin transacciones entrantes) y, a continuación, lo carga en OCI Object Storage. Por defecto, está definida en 5 segundos. Puede especificar un tiempo en milisegundos (ms), segundos (s), minutos (m) u horas (h). Por ejemplo, gg.handler.oci.inactivityRollInterval=10m.
  - gg.handler.oci.maxFileSize: el manejador de escritor de archivos abre el archivo y lo mantiene abierto hasta que este alcanza el tamaño máximo de archivo, suponiendo que no hay cambios de metadatos. Por defecto, el tamaño máximo de archivo es de 1 GB, pero puede cambiarlo mediante esta propiedad. Cuando se alcanza el tamaño, el archivo se cierra y se genera un nuevo archivo. Por ejemplo, gg.handler.oci.maxFileSize=500m.
  - gg.handler.oci.rollOnShutdown: el valor por defecto es true. Si está definido en true, GoldenGate cierra el archivo abierto al parar el proceso Replicat. Por defecto, el manejador de escritor de archivos mantiene el archivo abierto aunque Replicat se pare y continúa escribiendo en el mismo archivo cuando Replicat se reinicia. Por ejemplo, gg.handler.oci.rollOnShutdown=false
  - gg.handler.oci.fileRollInterval: indica la cantidad de tiempo que se mantiene el archivo abierto antes de que se cierre y se pase a un nuevo archivo. Por defecto, está definido en 7 minutos. Puede especificar un tiempo en milisegundos (ms), segundos (s), minutos (m) u horas (h). Por ejemplo, gg.handler.oci.fileRollInterval=10m.
  - gg.eventhandler.oci.bucketMappingTemplate: introduzca el nombre del cubo de Object Storage.
5. Haga clic en Crear y ejecutar.

Tarea 5: Verificación de la replicación

Realice algunas actualizaciones en la instancia de Autonomous Transaction Processing de origen para verificar la replicación en OCI Object Storage.

En la consola de Oracle Cloud, abra el menú de navegación, seleccione Oracle Database y, a continuación, seleccione Autonomous Transaction Processing.
En la lista de instancias de Autonomous Transaction Processing, seleccione la instancia de origen para ver los detalles.
En la página de detalles de la base de datos, haga clic en Acciones de base de datos.

Note:
Deberías estar conectado automáticamente. Si no es así, conéctese con las credenciales de la base de datos.
En la página inicial de acciones de base de datos, seleccione SQL.

Introduzca lo siguiente en la hoja de trabajo y haga clic en Ejecutar script.

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 ATP de origen, seleccione el nombre del Extract y, a continuación, haga clic en Estadísticas. Verifique que SRC_OCIGGLL.SRC_CITY tenga 10 inserciones.
En la consola de despliegue de OCI GoldenGate de Big Data de destino, seleccione el nombre del Replicat y, a continuación, haga clic en Estadísticas. Verifique que SRC_OCIGGLL.SRC_CITY tenga 10 inserciones.
En la consola de Oracle Cloud, desplácese hasta el cubo de OCI Object Storage y compruebe su contenido.

Tarea 6: Supervisión y mantenimiento de procesos

Más información

Obtenga más información sobre detalles de configuración y formatos de archivo admitidos.