Adición de un Replicat para Oracle Object Storage

Descubra cómo agregar y configurar un proceso de Replicat para el destino de Oracle Object Storage.

Antes de empezar

Antes de agregar el Replicat, asegúrese que tiene:

Adición de un Replicat (26ai)

Asegúrese de revisar los requisitos previos específicos de este tipo de destino.

  1. En el menú Replicat de la consola del despliegue de OCI GoldenGate, seleccione.

  2. En la página Replicat, seleccione Agregar Replicat.

  3. En el panel Agregar Replicat, en la página Información de Replicat, complete los campos según sea necesario y, a continuación, seleccione Siguiente:

    • Seleccione un Tipo de Replicat:

      • Replicat clásico

      • Replicación coordinada

    • Introduzca un nombre de proceso que no tenga más de 5 caracteres.

    • Introduzca una descripción para ayudar a distinguir este proceso de otros.

  4. En la página Opciones de Replicat, complete los campos según sea necesario y, a continuación, seleccione Siguiente:

    • Pista de Replicat:

      • Introduzca un nombre.

      • Introduzca un subdirectorio si espera que el archivo de pista esté en una ubicación que no sea la predeterminada.

      • Seleccione un perfil de cifrado. Si no se ha creado un perfil de cifrado, la cartera local estará seleccionada por defecto.

      • En Iniciar, seleccione el punto de inicio para procesamiento de datos:

        • Posición en log (valor por defecto)

        • Now

        • Hora personalizada

    • Posición de pista:

      • Introduzca el Número de secuencia.

      • Introduzca RBA Offset (Desplazamiento de RBA).

      • Seleccione el destino en la lista desplegable.

        Nota: Según la selección de destino, puede que tenga opciones adicionales, como las ubicaciones de flujo, almacenamiento provisional y fusión, y almacenamiento provisional.

    • Credenciales de Destino:

      • Seleccione un dominio.

      • Seleccione un alias dentro del dominio especificado.

      • Seleccione una tabla de puntos de control. Deje la selección por defecto o seleccione la tabla de puntos de Control que ha creado para el despliegue de destino.

      • Seleccione el número máximo de threads (solo réplicas coordinadas).

  5. En la página Opciones gestionadas, complete los campos opcionales según sea necesario y, a continuación, seleccione Siguiente:

    • Seleccione un nombre de perfil, si hay uno disponible.

    • Permite activar el estado crítico para el despliegue.

    • Active y configure la configuración de Inicio automático.

  6. En la página Archivo de Parámetros, puede agregar parámetros para configurar aún más el Replicat. Por ejemplo:

    table source.table1;

    Nota:

    GoldenGate utiliza el meridiano de Greenwich (GMT) por defecto. Utilice SETENV para sustituir la configuración por defecto de Replicat. Este cambio no se aplica a los despliegues. Por ejemplo:

    setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")

  7. En la página Archivo de Propiedades, configure las propiedades Manejador del Archivo y Manejador del Evento de OCI según sea necesario y, a continuación, seleccione Siguiente. Algunas propiedades cuya modificación se debe considerar son:

    1. gg.handler.name.format: seleccione cómo aplicar formato a los datos de salida. Las opciones disponibles son:

      • delimitedtext

      • json

      • json_row

      • xml

      • avro_row

      • avro_op

      • avro_row_ocf

      • avro_op_ocf

      Para parquet, debe aplicar propiedades adicionales. Consulte Parquet para Oracle Object Storage para obtener más información.

    2. gg.handler.name.fileNameMappingTemplate: genera nombres de archivo de forma dinámica mediante Palabras clave de plantilla.

    3. gg.handler.name.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, se carga en Oracle Object Storage.

    4. gg.eventhandler.name.compartmentID: introduzca el OCID del compartimento.

    5. gg.eventhandler.name.bucketMappingTemplate: introduzca el nombre de cubo de Object Storage.

    Obtenga más información acerca de las propiedades Manejador de escritor de archivos y Configuración de manejador de eventos de OCI.

    Nota: También puede agregar formateadores conectables según sea necesario. Para obtener más información, consulte Formatadores de conexión.

  8. Seleccione Crear y ejecutar. Si selecciona Crear, puede iniciar manualmente el Replicat más adelante desde la página Replicats.

Adición de un Replicat (21c)

  1. En la Consola de Despliegue de OCI GoldenGate, en la página Visión General del Servicio de Administración, seleccione Agregar Replicat (icono de signo mas).

  2. En la página Agregar Replicat, seleccione un tipo de Replicat y, a continuación, seleccione Siguiente.

    Los tipos de replicación son:

    • Replicat clásico

    • Replicación coordinada

  3. En la página Opciones de replicación, complete los siguientes campos y, a continuación, seleccione Siguiente:

    1. En Nombre del proceso, introduzca un nombre para el proceso de Replicat.

    2. (Opcional) En Descripción, introduzca una descripción breve para distinguir este proceso de otros.

    3. En Nombre de pista, introduzca un nombre de pista de dos caracteres.

    4. En Destino, seleccione Oracle Object Storage en la lista desplegable.

    5. Para ver los alias disponibles para OCI, seleccione su alias en la lista desplegable.

  4. En la página Archivo de Parámetros, agregue y configure parámetros de Replicat según sea necesario y, a continuación, seleccione Siguiente.

    table source.table1;

    Nota:

    GoldenGate utiliza el meridiano de Greenwich (GMT) por defecto. Utilice SETENV para sustituir la configuración por defecto de Extract. Este cambio sólo se aplica al proceso de extracción y no al despliegue.

    setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")

  5. En la página Archivo de Propiedades, configure las propiedades Manejador del Archivo y Manejador del Evento de OCI según sea necesario y, a continuación, seleccione Siguiente. Algunas propiedades cuya modificación se debe considerar son:

    1. gg.handler.name.format: seleccione cómo aplicar formato a los datos de salida. Las opciones disponibles son:

      • delimitedtext

      • json

      • json_row

      • xml

      • avro_row

      • avro_op

      • avro_row_ocf

      • avro_op_ocf

      Para parquet, debe aplicar propiedades adicionales. Consulte Parquet para Oracle Object Storage para obtener más información.

    2. gg.handler.name.fileNameMappingTemplate: genera nombres de archivo de forma dinámica mediante Palabras clave de plantilla.

    3. gg.handler.name.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, se carga en Oracle Object Storage.

    4. gg.eventhandler.name.compartmentID: introduzca el OCID del compartimento.

    5. gg.eventhandler.name.bucketMappingTemplate: introduzca el nombre de cubo de Object Storage.

    Obtenga más información sobre las propiedades Manejador de escritor de archivos y Manejador de eventos de OCI.

    Nota: También puede agregar formateadores conectables según sea necesario. Para obtener más información, consulte la sección sobre el uso de los formateadores conectables.

  6. Seleccione Agregar y ejecutar.

Volverá a la página Visión general del servicio de administración, donde podrá supervisar el estado del proceso de Replicat. Seleccione el nombre del proceso para ver los detalles y acceder a informes.

Contenido relacionado

Problemas conocidos relacionados con las conexiones de Oracle Object Storage

Error de replicación de Oracle Object Storage al utilizar la entidad de recurso

Si su conexión a Oracle Object Storage utiliza la autenticación de la entidad de recurso, el Replicat falla con el siguiente error:

ERROR 2025-06-12 14:48:16.000489 [main] - An exception has occurred: java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null java.lang.NullPointerException: Cannot invoke "String.startsWith(String)" because "path" is null

Solución alternativa: para solucionar este problema, edite la conexión y, a continuación, seleccione un método de autenticación diferente.

El OCID del usuario no coincide en la conexión de Oracle Object Storage (solo para usuarios federados)

Si un usuario federado selecciona Usar usuario actual al crear una conexión a Oracle Object Storage, su OCID no coincidirá con el OCID seleccionado por el sistema.

Solución alternativa: al crear una conexión a Oracle Object Storage, asegúrese en Especificar otro usuario y, a continuación, introduzca el OCID del usuario federado.

Para buscar el OCID del usuario, seleccione Perfil en la cabecera global de la consola de Oracle Cloud y, a continuación, seleccione el nombre de usuario. En la página Detalles de usuario, en Información de usuario, seleccione Mostrar en OCID.