Adición de un Extract para MongoDB

Un Extract es un proceso que se ejecuta en la conexión de origen de los datos de origen y que extrae, o captura, datos. Descubra cómo agregar un Extract para MongoDB.

Agregar un Extract (26ai)

Antes de comenzar, asegúrese de que:
  • Revise los detalles específicos de este tipo de conexión de origen.
  • Configure un juego de réplicas MongoDB:
    • OCI GoldenGate para Big Data utiliza el log de operaciones (oplog) para leer los registros de captura de datos de cambio (CDC). El oplog es una recopilación limitada en MongoDB que mantiene un registro sucesivo de todas las operaciones que modifican la base de datos. Los archivos de despliegue se crean cuando un juego de réplicas está activado en MongoDB.
    • MongoDB Atlas viene preconfigurado con un conjunto de Replicat. Para los despliegues locales de MongoDB, debe configurar y desplegar manualmente un juego de Replicat para activar la funcionalidad oplog y CDC. Para el entorno local MongoDB, debe desplegar un juego de réplicas.
  • Tenga MongoDB versión 3.6 o posterior.
  • Tenga soporte para OCI GoldenGate para capturar las siguientes operaciones: INSERT, UPDATE, DELETE.
Para agregar un Extract a MongoDB:
  1. En el menú Consola de despliegue GoldenGate de OCI, haga clic en Extracts.
  2. En el panel Agregar extracción, en la página Información de extracción, complete los siguientes campos según sea necesario y, a continuación, haga clic en Siguiente:
    • Introduzca un nombre de proceso que no tenga más de 8 caracteres.
    • Introduzca una descripción (opcional) que le ayude a distinguir este proceso de otros.
    • Seleccione un Origen en la lista desplegable.
  3. En la página Opciones de extracción, rellene los siguientes campos según sea necesario y, a continuación, haga clic en Siguiente:
    1. En Pista de extracción:
      1. Introduzca un nombre para el proceso de Extract.
      2. Introduzca un nombre de subdirectorio para definir una ubicación personalizada para el archivo de pista generado.
      3. Introduzca Secuencia de pista para definir el número de inicio para los archivos de pista.
      4. Introduzca un Tamaño de Pista para definir el tamaño máximo para el archivo del pista generado.
      5. Seleccione un Perfil de cifrado. El perfil Cartera local está seleccionado por defecto si no se ha creado un perfil de cifrado.
      6. Seleccione un algoritmo de cifrado:
        • NONE
        • AES256
        • AES192
        • AES128
    2. En Credenciales de origen, seleccione lo siguiente:
      1. Dominio
      2. Alias
      3. Cuándo y dónde comenzar
  4. En la página Opciones gestionadas, rellene los siguientes campos opcionales según sea necesario y, a continuación, haga clic en Siguiente:
    • Nombre del perfil
    • Crucial para estado de despliegue
    • Iniciar automáticamente
    • Reinicio automático

    Note:

    La adición de un perfil y la configuración de las opciones Inicio automático y Reinicio automático permiten que el despliegue se reinicie automáticamente después de una interrupción de la red. Consulte Configurar procesos gestionados para obtener más información.

  5. En la página Archivo de Parámetros, actualice la asignación de origen con TABLE source.*;

    Note:

    Esta es la asignación de recopilación/base de datos de origen. TABLE *.*; da como resultado el proceso de extracción de todas las bases de datos/recopilaciones.
  6. Haga clic en Crear y ejecutar para crear e iniciar el Extract. Si hace clic en Crear, puede iniciar manualmente la extracción más adelante desde la página Extracts.

Adición de un Extract (21c)

Aprenderá a agregar un proceso de extracción para un origen MongoDB en OCI GoldenGate

Para agregar un Extract para MongoDB:
  1. En la consola GoldenGate de despliegue de OCI, asegúrese de que está en la página Visión general del servicio de administración y, a continuación, haga clic enAgregar Extract (icono de signo mas).
  2. En la página Agregar Extract, en el tipo de Extract, seleccione una de las siguientes acciones y, a continuación, haga clic en Siguiente:
    • Carga Inicial
    • Captura de cambios en los datos
  3. En la página Opciones de Extract, complete los campos como se indica a continuación y, a continuación, haga clic en Siguiente:
    1. En Nombre de proceso, introduzca un nombre para la extracción.
    2. En Alias de conexión, seleccione el alias de conexión en la lista desplegable.
    3. En Origen, seleccione Archivo.
    4. En Nombre de archivo, introduzca tres caracteres como mínimo para el nombre de archivo.
    5. (Opcional) En Opciones gestionadas, puede configurar lo siguiente:
      • Nombre del perfil
      • Iniciar automáticamente
      • Reinicio automático

      Note:

      La adición de un perfil y la configuración de las opciones Inicio automático y Reinicio automático permiten que el despliegue se reinicie automáticamente después de una interrupción de la red. Consulte Configuración de Procesos Gestionados para obtener más información.
  4. En la página Archivo de Parámetros, actualice la asignación de origen con TABLE source.*;

    Note:

    Esta es la asignación de recopilación/base de datos de origen. TABLE *.*; da como resultado el proceso de extracción de todas las bases de datos/recopilaciones.
  5. Haga clic en Crear y ejecutar.
Volverá a la página Visión general del servicio de administración. Haga clic en el nombre de Extract para ver los detalles y los informes de Extract.

Incidencias conocidas

Replicats falla al utilizar Trail file de MongoDB Extract con BINARY_JSON_FORMAT

Cuando un Replicat utiliza un Trail file generado a partir de un MongoDB Extract con BINARY_JSON_FORMAT en el archivo de parámetros Extract, el Replicat falla con el siguiente error:

ERROR 2023-08-04 17:13:13.000421 [main] - Unable to decode column 0 : Input length = 1
      java.nio.charset.MalformedInputException: Input length = 1 at
      java.nio.charset.CoderResult.throwException(CoderResult.java:281) ~[?:1.8.0_311]at java.nio.charset.CharsetDecoder.decode(CharsetDecoder.java:816) ~[?:1.8.0_311] at
      oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1106)
      [ggdbutil-21.9.0.0.3.001.jar:21.9.0.0.3.001] Exception in thread “main”
      oracle.goldengate.util.GGException: Unable to decode column 0 : Input length = 1 at
      oracle.goldengate.datasource.UserExitDataSource.createColumnValue(UserExitDataSource.java:1203)

Solución alternativa: cuando se elimina BINARY_JSON_FORMAT de los parámetros Extract, Replicat se ejecuta correctamente y los documentos se representan en formato JSON extendido.