Adición de un Replicat para Copo de Nieve

Descubra cómo agregar un proceso de Replicat para un destino Snowflake en una replicación de datos de OCI GoldenGate.

Antes de empezar

Verifique que las tablas de destino existen en la base de datos Snowflake.
Debe tener configuradas las cuentas en la nube de Amazon Web Services, Google Cloud Platform o Azure si tiene la intención de utilizar cualquiera de las ubicaciones temporales externas, como S3, ADLS Gen2 o GCS.
Cadena de conexión del controlador JDBC de Snowflake
El usuario de la base de datos que se utiliza para la replicación en Snowflake debe tener los siguientes privilegios:
- INSERT, UPDATE, DELETE y TRUNCATE en las tablas de destino.
- CREATE y DROP en Snowflake denominado etapa y etapa externa.
- Si utiliza la etapa externa (S3, ADLS, GCS), la tabla externa CREATE, ALTER y DROP.
Revisión de Consideraciones de configuración y mejores prácticas para Snowflake

Adición de un Replicat (26ai)

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

En el menú Replicat de la consola del despliegue de OCI GoldenGate, seleccione.
En la página Replicat, seleccione Agregar Replicat.
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.
En la página Opciones de Replicat, complete los campos según sea necesario y, a continuación, seleccione Siguiente:
1. Para la 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
2. Para posición de pista:
  - Introduzca el Número de secuencia.
  - Introduzca RBA Offset (Desplazamiento de RBA).
3. En Destino, seleccione Lago de nieve en la lista desplegable y, a continuación, seleccione una de las siguientes opciones:
  1. Flujo
  2. Ubicar temporalmente y fusionar y, a continuación, seleccionar una ubicación temporal disponible
4. Para 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).
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.
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")
```
(Opcional) En la página Archivo de propiedades, revise la propiedad:
- jvm.bootoptions: aumente el valor -Xmx si necesita agregar más memoria a la JVM de Replicat (-Xmx16g para utilizar hasta 16 GB de memoria, -Xmx32g para hasta 32 GB, etc.).
  Nota: Un manejador de transmisión de copo de nieve relacionado con un problema conocido falla con el error Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper". Para solucionar este problema, agregue lo siguiente al archivo de propiedades de Replicat:
```
jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true
```
Para obtener información sobre las propiedades de este destino y conocer las diferencias entre los manejadores de almacenamiento provisional, fusión y transmisión, consulte Snowflake en la guía Oracle GoldenGate for Distributed Applications and Analytics.
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)

Para agregar un Replicat para Snowflake en Oracle GoldenGate 21c:

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).
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
En la página Opciones de replicación, complete los siguientes campos y, a continuación, seleccione Siguiente:
1. En Nombre de proceso, introduzca un nombre para el proceso de Replicat.
2. En Nombre de la pista, introduzca un nombre de la pista de dos carácter.
3. En Destino, seleccione la conexión Snowflake de destino en la lista desplegable.
4. En Alias disponibles, seleccione el alias en la lista desplegable.
5. (Opcional) Active el almacenamiento externo para seleccionar una ubicación temporal disponible en la lista desplegable.
En la página Parámetros de Replicat, agregue las asignaciones necesarias y, a continuación, seleccione Siguiente:
Nota:
- Si utiliza Replicat coordinado, 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/.properties
```
El uso de un replicado coordinado 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/001.properties" (error 2, No such file or directory).
```
- Si hay operaciones de fusión de larga ejecución en Snowflake y se observa un gran número de bloqueos, asegúrese de que ninguna otra tabla esté modificando la misma tabla. Además, utilice un replicado coordinado con precaución, ya que puede provocar un gran número de bloqueos de tabla.
- 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")
```
Más información sobre SETENV.
(Opcional) En la página Archivo de propiedades, revise las siguientes propiedades:

Nota: Estas propiedades se definen al crear la conexión y no se deben modificar aquí.
- ggs.eventhandler.snowflake.connectionURL: URL de JDBC para conectarse a Snowflake.
- ggs.eventhandler.snowflake.UserName: nombre de usuario de la base de datos Snowflake.
- ggs.eventhandler.snowflake.Password: contraseña asociada al usuario de la base de datos Snowflake.
- ggs.eventhandler.snowflake.storageIntegration: credencial para que el almacén de datos Snowflake acceda a los archivos de almacén de objetos respectivos. Para obtener más información, consulte Integración de almacenamiento Snowflake.
- jvm.bootoptions: aumente el valor -Xmx si necesita agregar más memoria a la JVM de Replicat (-Xmx16g para utilizar hasta 16 GB de memoria, -Xmx32g para hasta 32 GB, etc.)
Seleccione Crear y ejecutar. Si hace clic en Crear, puede iniciar manualmente el Replicat más tarde desde la página Visión general del servicio de administración.

Volverá a la página Visión general del servicio de administración, donde podrá ver la creación del proceso Replicat y acceder a las acciones de Replicat.

Detalles de objetivo de copo de nieve

Incidencias conocidas

Error 37518857: OGGDAA GGS Snowflake Streaming Replicat error

El manejador de transmisión de copo de nieve falla con: Exception: java.lang.StackOverflowError thrown from the UncaughtExceptionHandler in thread "process reaper"

Solución alternativa: agregue lo siguiente al archivo de propiedades de Replicat:

jvm.bootoptions= -Djdk.lang.processReaperUseDefaultStackSize=true