Migra MongoDB a Oracle AI Database sin tiempo de inactividad

Descubre cómo utilizar OCI GoldenGate para MongoDB en Oracle AI Database sin tiempo de inactividad.

OCI GoldenGate Big Data soporta migraciones desde MongoDB y MongoDB Atlas a los siguientes destinos sin tiempo de inactividad:

Autonomous AI JSON Database y Autonomous AI Database incluyen cadenas de conexión preconfiguradas de la API de Oracle para MongoDB que OCI GoldenGate utiliza para conectarse a los sistemas de destino de Oracle AI Database. Consulte Uso de la API de Oracle AI Database para MongoDB para obtener más información.

Si su destino es una instancia local de Oracle AI Database, puede utilizar Oracle Rest Data Services para activar la API de Oracle AI Database para MongoDB con su instancia local de Oracle AI Database.

Antes de empezar

Para completar correctamente este inicio rápido, asegúrese de que:

Configurar y ejecutar la migración

  1. En su MongoDB de origen, ejecute la utilidad de volcado MongoDB.

    1. Ejecute mongodump con la opción --oplog para crear una instantánea de la base de datos MongoDB de origen:

      $ ./bin/mongodump --uri="mongodb://localhost:27021" --oplog -v

      El comando devuelve lo siguiente:

      <date+timestamp>    getting most recent oplog timestamp
<date+timestamp>    writing admin.system.version to dump/admin/system.version.bson
<date+timestamp>    done dumping admin.system.version (1 document)
<date+timestamp>    dumping up to 4 collections in parallel
<date+timestamp>    writing testDB.coll1 to dump/testDB/coll1.bson
<date+timestamp>    writing testDB.coll2 to dump/testDB/coll2.bson
<date+timestamp>    writing testDB.coll3 to dump/testDB/coll3.bson
<date+timestamp>    done dumping testDB.coll3 (10000 documents)
<date+timestamp>    done dumping testDB.coll1 (10000 documents)
<date+timestamp>    done dumping testDB.coll2 (10000 documents)
<date+timestamp>    writing captured oplog to
<date+timestamp>    dumped 7 oplog entries

      Esto genera una carpeta de volcado que contiene el archivo de datos de archivo binario para todas las bases de datos y recopilaciones en la siguiente ubicación:

      dump/database-name/collection-name/collection-name.bson

      También crea un archivo oplog.bson directamente en la carpeta de volcado.

    2. Para inspeccionar el contenido del archivo oplog.bson (que está en formato binario), puede convertirlo a JSON mediante la utilidad bsondump:

      $ ./bin/bsondump --pretty --outFile /path/to/oplog.json dump/oplog.bson

      El comando devuelve lo siguiente:

      <date+timestamp>    7 objects found

  2. Extraiga los registros de hora de la primera y última operación de oplong.bson:

    1. Descargar el script OplogLSN.sh

    2. Ejecute el script OplongLSN.sh en MongoDB de origen en el mismo directorio donde se encuentra mongodump, transfiriendo la ubicación a oplog.bson como argumento de la siguiente manera:

      $./oplogLSN.sh /path/to/dump/oplog.bson

      El comando devuelve lo siguiente:

      <date+timestamp> 1 objects found
First LSN: 1740663867.1
Last LSN: 1740663946.211

    3. Inspeccione las entradas de Oplog. Si hubiera alguna operación entrante durante el volcado, el archivo oplog.bson contiene entradas para esas operaciones, cada una con un registro de hora. Puede utilizar OplogLSN.sh para capturar el primer y el último registro de hora de operación o convertirlo en un archivo JSON para inspección manual, como se muestra en el paso anterior.

  3. Ejecute la utilidad de restauración MongoDB. Utilice la utilidad mongorestore para restaurar las recopilaciones seleccionadas del volcado en la instancia de MongoDB de destino:

    $ ./mongorestore --uri="mongodb://localhost:27021" --nsInclude=testDB.coll1 --nsInclude=testDB.coll2 /path/to/dump -v

    El comando devuelve lo siguiente:

    <date+timestamp>    using write concern: &{majority <nil> 0s}
<date+timestamp>    using default 'dump' directory
<date+timestamp>    preparing collections to restore from
<date+timestamp>    found collection admin.system.version bson to restore to admin.system.version
<date+timestamp>    found collection metadata from admin.system.version to restore to admin.system.version
<date+timestamp>    don't know what to do with file "dump/oplog.json", skipping...
<date+timestamp>    found collection testDB.coll1 bson to restore to testDB.coll1
<date+timestamp>    found collection metadata from testDB.coll1 to restore to testDB.coll1
<date+timestamp>    found collection testDB.coll2 bson to restore to testDB.coll2
<date+timestamp>    found collection metadata from testDB.coll2 to restore to testDB.coll2
<date+timestamp>    reading metadata for testDB.coll1 from dump/testDB/coll1.metadata.json
<date+timestamp>    reading metadata for testDB.coll2 from dump/testDB/coll2.metadata.json
<date+timestamp>    creating collection testDB.coll1 with no metadata
<date+timestamp>    creating collection testDB.coll2 with no metadata
<date+timestamp>    restoring testDB.coll1 from dump/testDB/coll1.bson
<date+timestamp>    restoring testDB.coll2 from dump/testDB/coll2.bson
<date+timestamp>    finished restoring testDB.coll1 (10000 documents, 0 failures)
<date+timestamp>    finished restoring testDB.coll2 (10000 documents, 0 failures)
<date+timestamp>    no indexes to restore for collection testDB.coll1
<date+timestamp>    no indexes to restore for collection testDB.coll2
<date+timestamp>    20000 document(s) restored successfully. 0 document(s) failed to restore.

    El comando restaura los datos, los metadatos y las definiciones de índice para la recopilación especificada en la instancia de destino MongoDB/ORDS. Por ejemplo, coll1 y coll2 en la base de datos testDB como se muestra en la salida anterior.

  4. Cree y ejecute una extracción de captura de datos de cambio (CDC) en el despliegue de Big Data de origen para MongoDB. Inicie el extracto de MongoDB CDC desde el primer registro de hora de operación (primer LSN) obtenido en el paso 2b. Esto garantiza que la extracción de CDC captura las operaciones que se producen después de que se inicia el proceso de volcado.

  5. Crear y ejecutar un Replicat de MongoDB.

    1. Utilice el archivo de pista de CDC generado del paso 4.

    2. Establezca oplongReplayLastLsn en el último registro de hora de operación (Último LSN) obtenido en el paso 2b, o la ruta a oplog.bson y el último LSN se obtiene automáticamente. Esto garantiza que Replicat se ejecute en modo oplong-replay, evitando colisiones y garantizando un inicio preciso sin pérdida ni duplicación de datos. Después de procesar el último registro de hora, el Replicat continúa en modo normal.

Sugerencias

Estos son algunos consejos para garantizar que la migración se realice sin problemas: