Documentación de Oracle Cloud Infrastructure

Adición de un Replicat para Snowflake

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

Adición de un Replicat (23ai)

Antes de empezar

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

Para agregar un Replicat en GoldenGate 23ai:
  1. En la consola de despliegue GoldenGate de OCI, en la página de inicio del servicio de administración, haga clic en Agregar Replicat (icono de signo más).
  2. 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 replicado:
      • 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.
  3. En la página Opciones de replicación, complete los campos según sea necesario y, a continuación, haga clic en Siguiente:
    1. Para 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 ubicación por defecto.
      • 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)
        • Ahora
        • Hora personalizada
    2. Para posición de pista:
      • Introduzca el número de secuencia.
      • Introduzca el desplazamiento de RBA.
    3. En Destino, seleccione Snowflake en la lista desplegable y, a continuación, seleccione una de las siguientes opciones:
      1. Streaming
      2. Ubicar temporalmente y fusionar y, a continuación, seleccionar una ubicación temporal disponible
    4. Para credenciales de destino:
      • Seleccionar un dominio.
      • Seleccione un alias en el 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).
  4. 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 Crítico para estado de despliegue.
    • Active y configure los valores de Inicio automático.
  5. 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 Coordinated Replicat, agregue TARGETDB LIBFILE libggjava.so SET property=/u02/Deployment/etc/conf/ogg/your_replicat_name.properties al archivo de parámetros.

    Nota

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

    setenv (TZ="US/Eastern")
setenv (TZ="GMT+5")
  6. (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 problema conocido relacionado con Snowflake Streaming Handler 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 y fusión y flujo, consulte Snowflake en la guía Oracle GoldenGate for Distributed Applications and Analytics.

  7. Haga clic en Crear y ejecutar. Si hace clic en Crear, puede iniciar manualmente la replicación más tarde desde la página inicial del servicio de administración.

Adición de un Replicat (21c)

Para agregar un Replicat para Snowflake en Oracle GoldenGate 21c:
  1. En la consola de despliegue GoldenGate de OCI, en la página Visión general del servicio de administración, haga clic en Agregar Replicat (icono de signo más).
  2. 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
  3. En la página Opciones de replicación, complete los siguientes campos y, a continuación, haga clic en Siguiente:
    1. En Nombre de proceso, introduzca un nombre para el proceso de Replicat.
    2. En Nombre de pista, introduzca un nombre de pista de dos caracteres.
    3. En Destino, seleccione la conexión de Snowflake de destino en la lista desplegable.
    4. En Alias disponibles, seleccione su alias en la lista desplegable.
    5. (Opcional) Active el almacenamiento externo para seleccionar una ubicación temporal disponible en la lista desplegable.
  4. En la página Parámetros de Replicat, agregue las asignaciones necesarias y, a continuación, haga clic en Siguiente:
    Nota

    • 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 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/<replicat name>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 el replicado coordinado con precaución, ya que puede provocar un gran número de bloqueos de tabla.
    • GoldenGate utiliza la hora del 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.

  5. (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 de Snowflake.
    • ggs.eventhandler.snowflake.Password: contraseña asociada al usuario de base de datos de Snowflake.
    • ggs.eventhandler.snowflake.storageIntegration: credencial del almacén de datos de Snowflake para acceder a los archivos del almacén de objetos respectivos. Para obtener más información, consulte Integración de almacenamiento de 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 un máximo de 32 GB, etc.)
  6. Haga clic en 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 puede ver la creación del proceso de Replicat y acceder a las acciones del Replicat.