Replicación de datos entre bases de datos en la nube de la misma región

Descubra cómo configurar Oracle Cloud Infrastructure GoldenGate para replicar datos entre dos instancias de Autonomous Database.

Descripción general

Oracle Cloud Infrastructure GoldenGate permite replicar bases de datos soportadas dentro de la misma región. Los siguientes pasos le guiarán a través del proceso para instanciar una base de datos de destino mediante Oracle Data Pump y replicar datos del origen en el destino.

Este inicio rápido también está disponible como LiveLab: Ver el taller.

Descripción de la ilustración misma-region.png

Antes de empezar

Para continuar, debe tener lo siguiente:

• Una base de datos de origen existente
• Una base de datos destino existente
• La base de datos de origen y destino deben estar en un único arrendamiento, en la misma región
• Si necesita datos de ejemplo, descargue Archive.zip y, a continuación, siga las instrucciones de Laboratorio 1, Tarea 3: Carga del esquema ATP.

Tarea 1: Configuración del entorno

1. Cree un despliegue de replicación de datos.
2. Cree una conexión de origen de Oracle Autonomous Transaction Processing (ATP).
3. Cree una conexión de Autonomous Data Warehouse (ADW) de destino.
4. Assign a connection to the deployment.
5. Utilice la herramienta SQL de Autonomous Database para activar el registro complementario:

   ALTER DATABASE ADD SUPPLEMENTAL LOG DATA

6. Ejecute la siguiente consulta en la herramienta SQL para asegurarse de que support_mode=FULL para todas las tablas de la base de datos origen:

   
   select * from DBA_GOLDENGATE_SUPPORT_MODE where owner = 'SRC_OCIGGLL';

Tarea 2: Creación del Extract integrado

Un Extract integrado captura los cambios en curso en la base de datos de origen.

1. En la página Detalles del despliegue, haga clic en Iniciar consola.
2. Si es necesario, introduzca oggadmin para el nombre de usuario y la contraseña que utilizó al crear el despliegue y, a continuación, haga clic en Conectar.
3. Agregar datos de transacción y una tabla de puntos de control:
   1. Abra el menú de navegación y, a continuación, haga clic en Conexiones de base de datos.
   2. Haga clic en Conectar a la base de datos SourceATP.
   3. En el menú de navegación, haga clic en Trandata y, a continuación, en Agregar Trandata (icono de signo más).
   4. En Nombre de esquema, introduzca SRC_OCIGGLL y, a continuación, haga clic en Enviar.
   5. Para verificarlo, introduzca SRC_OCIGGLL en el campo Buscar y haga clic en Buscar.
   6. Abra el menú de navegación y, a continuación, haga clic en Conexiones de base de datos.
   7. Haga clic en Conectar a la base de datos TargetADW.
   8. En el menú de navegación, haga clic en Punto de Control y, a continuación, en Agregar Punto de Control (icono de signo más).
   9. En Tabla de puntos de control, introduzca "SRCMIRROR_OCIGGLL"."CHECKTABLE" y, a continuación, haga clic en Enviar.
4. Agregue un Extract.

   Note:

   Consulte opciones de parámetros de extracción adicionales para obtener más información sobre los parámetros que puede utilizar para especificar tablas de origen.

   En la página Parámetros de extracción, agregue las siguientes líneas en EXTTRAIL <trail-name>:

   -- Capture DDL operations for listed schema tables
   ddl include mapped
   
   -- Add step-by-step history of 
   -- to the report file. Very useful when troubleshooting.
   ddloptions report 
   
   -- Write capture stats per table to the report file daily.
   report at 00:01 
   
   -- Rollover the report file weekly. Useful when IE runs
   -- without being stopped/started for long periods of time to
   -- keep the report files from becoming too large.
   reportrollover at 00:01 on Sunday 
   
   -- Report total operations captured, and operations per second
   -- every 10 minutes.
   reportcount every 10 minutes, rate 
   
   -- Table list for capture
   table SRC_OCIGGLL.*;

5. Compruebe si hay transacciones de larga duración. Ejecute el siguiente script en la base de datos de origen:

   select start_scn, start_time from gv$transaction where start_scn < (select max(start_scn) from dba_capture);

   Si la consulta devuelve alguna fila, debe buscar el SCN de la transacción y, a continuación, confirmar o realizar un rollback de la transacción.

Tarea 3: Exportación de datos mediante Oracle Data Pump (ExpDP)

Utilice Oracle Data Pump (ExpDP) para exportar datos de la base de datos de origen a Oracle Object Store.

1. Creación de un cubo de Oracle Object Store.

   Tome nota del espacio de nombres y del nombre del cubo para utilizarlos con los scripts de exportación e importación.

2. Cree un token de autenticación y, a continuación, copie y pegue la cadena de token en un editor de texto para su uso posterior.
3. Cree una credencial en la base de datos de origen sustituyendo <user-name> y <token> por su nombre de usuario de cuenta de Oracle Cloud y la cadena de token que ha creado en el paso anterior:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'ADB_OBJECTSTORE', 
       username => '<user-name>',
       password => '<token>'
     );
   END;

4. Ejecute el siguiente script en la base de datos de origen para crear el trabajo Exportar datos. Asegúrese de sustituir <region>, <namespace> y <bucket-name> en el URI de Object Store según corresponda. SRC_OCIGGLL.dmp es un archivo que se creará cuando se ejecute este script.

   DECLARE
   ind NUMBER;              -- Loop index
   h1 NUMBER;               -- Data Pump job handle
   percent_done NUMBER;     -- Percentage of job complete
   job_state VARCHAR2(30);  -- To keep track of job state
   le ku$_LogEntry;         -- For WIP and error messages
   js ku$_JobStatus;        -- The job status from get_status
   jd ku$_JobDesc;          -- The job description from get_status
   sts ku$_Status;          -- The status object returned by get_status
   
   BEGIN
   -- Create a (user-named) Data Pump job to do a schema export.
   h1 := DBMS_DATAPUMP.OPEN('EXPORT','SCHEMA',NULL,'SRC_OCIGGLL_EXPORT','LATEST');
   
   -- Specify a single dump file for the job (using the handle just returned
   -- and a directory object, which must already be defined and accessible
   -- to the user running this procedure.
   DBMS_DATAPUMP.ADD_FILE(h1,'https://objectstorage.<region>.oraclecloud.com/n/<namespace>/b/<bucket-name>/o/SRC_OCIGGLL.dmp','ADB_OBJECTSTORE','100MB',DBMS_DATAPUMP.KU$_FILE_TYPE_URIDUMP_FILE,1);
   
   -- A metadata filter is used to specify the schema that will be exported.
   DBMS_DATAPUMP.METADATA_FILTER(h1,'SCHEMA_EXPR','IN (''SRC_OCIGGLL'')');
   
   -- Start the job. An exception will be generated if something is not set up properly.
   DBMS_DATAPUMP.START_JOB(h1);
   
   -- The export job should now be running. In the following loop, the job
   -- is monitored until it completes. In the meantime, progress information is displayed.
   percent_done := 0;
   job_state := 'UNDEFINED';
   while (job_state != 'COMPLETED') and (job_state != 'STOPPED') loop
     dbms_datapump.get_status(h1,dbms_datapump.ku$_status_job_error + dbms_datapump.ku$_status_job_status + dbms_datapump.ku$_status_wip,-1,job_state,sts);
     js := sts.job_status;
   
   -- If the percentage done changed, display the new value.
   if js.percent_done != percent_done
   then
     dbms_output.put_line('*** Job percent done = ' || to_char(js.percent_done));
     percent_done := js.percent_done;
   end if;
   
   -- If any work-in-progress (WIP) or error messages were received for the job, display them.
   if (bitand(sts.mask,dbms_datapump.ku$_status_wip) != 0)
   then
     le := sts.wip;
   else
     if (bitand(sts.mask,dbms_datapump.ku$_status_job_error) != 0)
     then
       le := sts.error;
     else
       le := null;
     end if;
   end if;
   if le is not null
   then
     ind := le.FIRST;
     while ind is not null loop
       dbms_output.put_line(le(ind).LogText);
       ind := le.NEXT(ind);
     end loop;
   end if;
     end loop;
   
     -- Indicate that the job finished and detach from it.
     dbms_output.put_line('Job has completed');
     dbms_output.put_line('Final job state = ' || job_state);
     dbms_datapump.detach(h1);
   END;

Tarea 4: Instanciación de la base de datos de destino mediante Oracle Data Pump (ImpDP)

Utilice Oracle Data Pump (ImpDP) para importar datos a la base de datos de destino desde SRC_OCIGGLL.dmp que se ha exportado de la base de datos de origen.

1. Cree una credencial en la base de datos de destino para acceder a Oracle Object Store (con la misma información de la sección anterior).

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL( 
       credential_name => 'ADB_OBJECTSTORE',
       username => '<user-name>',
       password => '<token>'
     );
   END;

2. Ejecute el siguiente script en la base de datos de destino para importar datos de SRC_OCIGGLL.dmp. Asegúrese de sustituir <region>, <namespace> y <bucket-name> en el URI de Object Store según corresponda:

   DECLARE
   ind NUMBER;  -- Loop index
   h1 NUMBER;  -- Data Pump job handle
   percent_done NUMBER;  -- Percentage of job complete
   job_state VARCHAR2(30);  -- To keep track of job state
   le ku$_LogEntry;  -- For WIP and error messages
   js ku$_JobStatus;  -- The job status from get_status
   jd ku$_JobDesc;  -- The job description from get_status
   sts ku$_Status;  -- The status object returned by get_status
   BEGIN
   
   -- Create a (user-named) Data Pump job to do a "full" import (everything
   -- in the dump file without filtering).
   h1 := DBMS_DATAPUMP.OPEN('IMPORT','FULL',NULL,'SRCMIRROR_OCIGGLL_IMPORT');
   
   -- Specify the single dump file for the job (using the handle just returned)
   -- and directory object, which must already be defined and accessible
   -- to the user running this procedure. This is the dump file created by
   -- the export operation in the first example.
   
   DBMS_DATAPUMP.ADD_FILE(h1,'https://objectstorage.<region>.oraclecloud.com/n/<namespace>/b/<bucket-name>/o/SRC_OCIGGLL.dmp','ADB_OBJECTSTORE',null,DBMS_DATAPUMP.KU$_FILE_TYPE_URIDUMP_FILE);
   
   
   -- A metadata remap will map all schema objects from SRC_OCIGGLL to SRCMIRROR_OCIGGLL.
   DBMS_DATAPUMP.METADATA_REMAP(h1,'REMAP_SCHEMA','SRC_OCIGGLL','SRCMIRROR_OCIGGLL');
   
   -- If a table already exists in the destination schema, skip it (leave
   -- the preexisting table alone). This is the default, but it does not hurt
   -- to specify it explicitly.
   DBMS_DATAPUMP.SET_PARAMETER(h1,'TABLE_EXISTS_ACTION','SKIP');
   
   -- Start the job. An exception is returned if something is not set up properly.
   DBMS_DATAPUMP.START_JOB(h1);
   
   -- The import job should now be running. In the following loop, the job is
   -- monitored until it completes. In the meantime, progress information is
   -- displayed. Note: this is identical to the export example.
   percent_done := 0;
   job_state := 'UNDEFINED';
   while (job_state != 'COMPLETED') and (job_state != 'STOPPED') loop
     dbms_datapump.get_status(h1,
       dbms_datapump.ku$_status_job_error +
       dbms_datapump.ku$_status_job_status +
       dbms_datapump.ku$_status_wip,-1,job_state,sts);
       js := sts.job_status;
   
     -- If the percentage done changed, display the new value.
     if js.percent_done != percent_done
     then
       dbms_output.put_line('*** Job percent done = ' ||
       to_char(js.percent_done));
       percent_done := js.percent_done;
     end if;
   
     -- If any work-in-progress (WIP) or Error messages were received for the job, display them.
     if (bitand(sts.mask,dbms_datapump.ku$_status_wip) != 0)
     then
       le := sts.wip;
     else
       if (bitand(sts.mask,dbms_datapump.ku$_status_job_error) != 0)
       then
         le := sts.error;
       else
         le := null;
       end if;
     end if;
     if le is not null
     then
       ind := le.FIRST;
       while ind is not null loop
         dbms_output.put_line(le(ind).LogText);
         ind := le.NEXT(ind);
       end loop;
     end if;
   end loop;
   
   -- Indicate that the job finished and gracefully detach from it.
   dbms_output.put_line('Job has completed');
   dbms_output.put_line('Final job state = ' || job_state);
   dbms_datapump.detach(h1);
   END;

Tarea 5: Adición y ejecución de un Replicat sin integrar

1. Agregue y ejecute un Replicat.
   En la pantalla Archivo de parámetros, sustituya MAP *.*, TARGET *.*; por el siguiente script:

   -- Capture DDL operations for listed schema tables
   --
   ddl include mapped
   --
   -- Add step-by-step history of ddl operations captured
   -- to the report file. Very useful when troubleshooting.
   --
   ddloptions report
   --
   -- Write capture stats per table to the report file daily.
   --
   report at 00:01
   --
   -- Rollover the report file weekly. Useful when PR runs
   -- without being stopped/started for long periods of time to
   -- keep the report files from becoming too large.
   --
   reportrollover at 00:01 on Sunday
   --
   -- Report total operations captured, and operations per second
   -- every 10 minutes.
   --
   reportcount every 10 minutes, rate
   --
   -- Table map list for apply
   --
   DBOPTIONS ENABLE_INSTANTIATION_FILTERING;
   MAP SRC_OCIGGLL.*, TARGET SRCMIRROR_OCIGGLL.*;

   Note:

   DBOPTIONS ENABLE_INSTATIATION_FILTERING activa el filtrado de CSN en las tablas importadas mediante Oracle Data Pump. Para obtener más información, consulte la referencia de DBOPTIONS.
2. Realice inserciones en la base de datos origen:
   1. Vuelva a la consola de Oracle Cloud y utilice el menú de navegación para volver a Oracle Database, Autonomous Transaction Processing y, a continuación, a SourceATP.
   2. En la página Detalles de ATP de origen, haga clic en Herramientas y, a continuación, en Acciones de base de datos.
   3. Utilice las credenciales de la base de datos ATP de origen en los detalles del taller para conectarse a las acciones de base de datos y, a continuación, haga clic en SQL.
   4. Introduzca las siguientes inserciones y, a continuación, 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);

   5. En la consola de despliegue GoldenGate de OCI, haga clic en el nombre de extracción (UAEXT) y, a continuación, en Estadísticas. Verifique que SRC_OCIGGLL.SRC_CITY se muestre con 10 inserciones.
   6. Vuelva a la pantalla Visión general, haga clic en Nombre de replicación (REP) y, a continuación, haga clic en Estadísticas. Verifique que SRCMIRROR_OCIGGLL.SRC_CITY se muestre con 10 inserciones

Tarea 6: Supervisión y mantenimiento de procesos

1. Supervise el proceso de replicación.
2. Gestione los archivos de pista.

---

Título e Información de Copyright

Copyright ©2022,

Oracle y/o sus filiales.