Adición de un Replicat para OCI Object Storage

Descubra la adición y configuración de un proceso de Replicat para un destino de OCI Object Storage.

Temas relacionados

Antes de empezar

Antes de agregar el Replicat, asegúrese de tener lo siguiente:

OCID de compartimento
Sugerencia:
Puede encontrar el OCID del compartimento en la página Detalles del compartimento.
1. Abra el menú de navegación de la consola de Oracle Cloud, seleccione Identity y, a continuación, Compartments.
2. Seleccione el compartimento en la lista para acceder a la página Detalles del compartimento.
3. Copie el OCID del compartimento de la sección Información del compartimento.
Para obtener más información, consulte Búsqueda del OCID de un compartimento.
Nombre del cubo de OCI Object Storage
Sugerencia:
Oracle le recomienda crear su propio cubo de OCI Object Storage.
1. Abra el menú de navegación de la consola de Oracle Cloud, seleccione Storage y, a continuación, Buckets.
2. Haga clic en Crear cubo.
3. En el panel Crear cubo, introduzca un nombre y, a continuación, haga clic en Crear.
Para obtener más información, consulte la sección sobre el uso de la consola para crear un cubo.

Adición de un Replicat (23ai)

Antes de empezar

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

Para agregar un Replicat en GoldenGate 23ai:

En la consola de despliegue de GoldenGate de OCI, en la página inicial de Administration Service, haga clic en Agregar Replicat (icono de signo más).
En el panel Agregar Replicat, en la página Información de Replicat, complete los campos según sea necesario y, a continuación, haga clic en Siguiente:
- Seleccione un tipo de Replicat:
  - Replicat clásico
  - Replicación coordinada
- Introduzca un Nombre de proceso de no más de 5 caracteres.
- Introduzca una descripción para ayudar a distinguir este proceso de otros.
En la página Opciones de replicación, complete los campos según sea necesario y, a continuación, haga clic en Siguiente:
- Pista de replicación:
  - 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 el procesamiento de datos:
    - Posición en log (valor por defecto)
    - Now
    - Hora personalizada
- Posición de pista:
  - Introduzca el número de secuencia.
  - Introduzca el RBA Offset (Desplazamiento de RBA).
  - Seleccione el destino en la lista desplegable.
    
    Note:
    En función de la selección de destino, puede que tenga opciones adicionales, como ubicaciones de transmisión, almacenamiento provisional y fusión, y ubicación temporal.
- Credenciales de Destino:
  - Seleccionar un dominio.
  - Seleccione un alias dentro del dominio especificado.
  - Seleccione una tabla de punto 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 Replicats coordinados).
En la página Opciones gestionadas, complete los campos opcionales según sea necesario y, a continuación, haga clic en Siguiente:
- Seleccione un nombre de perfil, si hay uno disponible.
- Active Critical para estado de despliegue.
- Active y configure los valores de inicio automático.
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;
```
Si utiliza Replicat coordinado, agregue TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/your_replicat_name.properties al archivo de parámetros.
Note:

GoldenGate utiliza la hora media de Greenwich (GMT) por defecto. Utilice SETENV para sustituir la configuración por defecto para este proceso de Replicat. Este cambio no se aplica a los despliegues. Por ejemplo:
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
En la página Archivo de propiedades, configure las propiedades Controlador de archivos y Controlador de eventos de OCI según sea necesario y, a continuación, haga clic en 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 el parquet, debe aplicar propiedades adicionales. Consulte Parquet para OCI 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 OCI Object Storage.
4. gg.eventhandler.name.compartmentID: introduzca el OCID del compartimento.
5. gg.eventhandler.name.bucketMappingTemplate: introduzca el nombre del cubo de Object Storage.
Obtenga más información sobre las propiedades M manejador de escritor de archivos y Configuración de manejador de eventos de OCI.

Note:
También puede agregar formateadores conectables según sea necesario. Para obtener más información, consulte Pluggable Formatters.
Haga clic en Crear y ejecutar. Si hace clic en Crear, puede iniciar manualmente el replicación más tarde desde la página de inicio de Servicio de administración.

Adición de un Replicat (21c)

Para agregar un Replicat para un destino de OCI Object Storage:

En la consola de despliegue de OCI GoldenGate, en la página Visión general del servicio de administración, haga clic en Agregar Replicato (icono de signo más).
En la página Agregar Replicat, seleccione un Tipo de Replicat y, a continuación, haga clic en Siguiente.
Los tipos de replicación son:
- Replicat clásico
- Replicación coordinada
En la página Opciones de replicación, complete los siguientes campos y, a continuación, haga clic en 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.
En la página Archivo de parámetros, agregue y configure los parámetros de Replicat según sea necesario y, a continuación, haga clic en Siguiente.
Note:
- Si utiliza Coordinated Replicat, agregue los siguientes parámetros en la segunda línea del archivo de parámetros:
```
TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/<replicat
      name>.properties
```
  El uso de réplicas coordinadas dará como resultado la creación de varios archivos.
  
  Si se omite, se producirá el siguiente error:
```
OGG-01091 Oracle GoldenGate Delivery, RSNOW.prm: Unable to open file
      "/u02/Deployment/etc/conf/ogg/<replicat name>001.properties" (error 2, No such file or
      directory).
```
- GoldenGate utiliza la hora media de Greenwich (GMT) por defecto. Utilice SETENV para sustituir la configuración por defecto. Por ejemplo:
```
setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
```
  Más información sobre SETENV.
En la página Archivo de propiedades, configure las propiedades Controlador de archivos y Controlador de eventos de OCI según sea necesario y, a continuación, haga clic en 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 el parquet, debe aplicar propiedades adicionales. Consulte Parquet para OCI 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 OCI Object Storage.
4. gg.eventhandler.name.compartmentID: introduzca el OCID del compartimento.
5. gg.eventhandler.name.bucketMappingTemplate: introduzca el nombre del cubo de Object Storage.
Obtenga más información sobre las propiedades Manejador de escritor de archivos y Manejador de eventos de OCI.

Note:
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.
Haga clic en 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. Haga clic en el nombre del proceso para ver los detalles y acceder a los informes.

Incidencias conocidas

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

Si se utiliza una entidad de recurso para la autenticación, el Replicat fallará y se producirá 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

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

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

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

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

Título e Información de Copyright

Oracle y/o sus filiales.