Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Manual de estrategias sobre migración: MongoDB a Amazon DocumentDB

Este manual de estrategias sobre migración le proporciona recursos y pasos para migrar de una base de datos de MongoDB a Amazon DocumentDB.

Proceso de migración

A continuación, se enumeran los pasos de alto nivel que suelen implicar la migración de los datos de una base de datos de MongoDB a Amazon DocumentDB.

Paso 1: diferencias funcionales y de compatibilidad

Amazon DocumentDB interactúa con MongoDB 3.6, 4.0 y 5.0 de código abierto Apache 2.0. APIs Como resultado, puede usar los mismos controladores, aplicaciones y herramientas de MongoDB que Amazon DocumentDB con pocos o ningún cambio.

El primer paso consiste en comprobar la compatibilidad entre los operadores e índices que utiliza la aplicación en la base de datos de MongoDB y su disponibilidad en Amazon DocumentDB, así como comprender las diferencias funcionales entre ellos.

Compatibilidad de los operadores

Utilice la Herramienta de compatibilidad de Amazon DocumentDB* para descubrir fácilmente si la aplicación utiliza operadores no compatibles en sus consultas. Esta herramienta puede escanear los archivos de registro del servidor de base de datos MongoDB o el código fuente de la aplicación para proporcionar un informe de los operadores no compatibles. Si detecta el uso de operadores no compatibles, tendrá que modificar la aplicación para evitar el uso de operadores no compatibles.

Para comprobar la compatibilidad entre los operadores de MongoDB utilizados en la configuración y los operadores de Amazon DocumentDB compatibles, ejecute lo siguiente:

git clone https://github.com/awslabs/amazon-documentdb-tools.git
cd amazon-documentdb-tools/compat-tool/
python3 compat.py --version <Amazon DocumentDB version> --directory <mongodb logfiles/source code>

Para obtener más información, consulte APIsMongoDB, operaciones y tipos de datos compatibles en Amazon DocumentDB.

^{* No es compatible oficialmente con AWS.}

Compatibilidad de índices

Puede utilizar la Herramienta de indexación de Amazon DocumentDB* para averiguar si está utilizando algún tipo de índice que no sea compatible con Amazon DocumentDB. Esta herramienta necesita una conexión a la base de datos de origen para leer las definiciones de los índices.

Para ello, primero debe volcar las definiciones de índice en un directorio mediante la opción --dump-indexes. A continuación, ejecute la herramienta con la opción --show-issues y proporcione el directorio para localizar los índices incompatibles.

Índices de exportación:

git clone https://github.com/awslabs/amazon-documentdb-tools.git
sudo pip install -r amazon-documentdb-tools/index-tool/requirements.txt
mkdir <directory to dump index definitions>
python3 migrationtools/documentdb_index_tool.py --dump-indexes --dir <directory> --uri <source-mongodb-uri>

Compruebe si hay índices incompatibles:

python3 migrationtools/documentdb_index_tool.py --show-issues --dir <dumped-index-definitions-directory>

Si detecta el uso de algún tipo de índice no compatible, debe modificar la aplicación o el modelo de datos para evitar los índices incompatibles o continuar sin ellos.

Para obtener más información sobre los tipos y propiedades de índices admitidos en Amazon DocumentDB, consulte Índices y propiedades de índices y How to index on Amazon DocumentDB.

^{* No es compatible oficialmente con AWS.}

Diferencias funcionales

Revise Diferencias funcionales con MongoDB para familiarizarse con las diferencias.

Paso 2: prueba de concepto

Para hacer una prueba de concepto, ejecute la aplicación o el conjunto de pruebas habitual en Amazon DocumentDB para comprobar su funcionalidad y rendimiento. Es posible que necesite rellenar el clúster de Amazon DocumentDB con datos para hacer las pruebas. Por ejemplo, puede usar las herramientas mongodump y mongorestore para copiar datos del origen de MongoDB.

Pruebas funcionales

Cree un clúster de Amazon DocumentDB (consulte Creación de un clúster de Amazon DocumentDB) y ejecute la aplicación o el conjunto de pruebas funcionales para comprobar si todos los flujos de trabajo de la aplicación siguen funcionando sin problemas en Amazon DocumentDB.

Pruebas de rendimiento

Haga pruebas de rendimiento en la aplicación o conjunto de pruebas de rendimiento que se ejecute en Amazon DocumentDB con una carga de trabajo similar a la carga de trabajo de producción para comprobar si la configuración cumple los requisitos de latencia. Afine la carga de trabajo para mejorar el rendimiento o escale el clúster de Amazon DocumentDB según corresponda. Para obtener más información, consulte Rendimiento y utilización de recursos y Escalado de clústeres de Amazon DocumentDB.

Es importante dimensionar el clúster de Amazon DocumentDB con los tipos de instancias correctos para obtener un rendimiento óptimo. Para obtener más información, consulte las prácticas recomendadas de Determinación del tamaño de las instancias.

Puede utilizar la Calculadora de tamaño de Amazon DocumentDB* para ayudar a estimar el tamaño del clúster de Amazon DocumentDB.

^{* No es compatible oficialmente con AWS.}

Prueba de conmutación por error

Es posible que desee observar cómo responde la aplicación a un reinicio del nodo principal de Amazon DocumentDB, a una conmutación por error del nodo principal o a una eliminación de un nodo principal en un clúster de varios nodos, así como cuándo se reinician o eliminan los nodos de réplica. Esto le ayudará a confirmar que la aplicación es resistente a estos eventos. Para obtener más información, consulte Prueba de conmutación por error.

Para comprender las excepciones que debe tolerar una aplicación y cómo gestionarlas de forma eficiente, consulte Building resilient applications with Amazon DocumentDB.

Paso 3: migración de los datos

Tras hacer una prueba de concepto satisfactoria, migre los datos a Amazon DocumentDB. La mayoría de nuestros clientes utilizan enfoques de migración en línea o fuera de línea para migrar sus datos.

Migración en línea

Con el método de migración en línea, puede migrar datos de la base de datos de origen, desde unos pocos gigabytes hasta varios terabytes, a Amazon DocumentDB con un tiempo de inactividad prácticamente nulo. Para obtener más información, consulte ().AWS Database Migration ServiceAWS DMS

Si está migrando desde una base de datos de MongoDB, puede AWS DMS utilizarla para realizar una carga completa y replicar los cambios en curso.

Para ver un step-by-step proceso, consulte Migración a Amazon DocumentDB con el método en línea.

Puede encontrar más información en la sección Using Amazon DocumentDB as a target for AWS Database Migration Service en la Guía del usuario de AWS Database Migration Service .

Puntos a tener en cuenta con: AWS DMS

Migración sin conexión

La migración sin conexión es el enfoque más sencillo para mover bases de datos a Amazon DocumentDB. Este enfoque se utiliza principalmente para POCs y para las cargas de trabajo que pueden sufrir tiempos de inactividad de escritura durante la migración.

Para ver un step-by-step proceso, consulte Migración de MongoDB a Amazon DocumentDB mediante el método offline.

Paso 4: validación de datos

Una vez que los datos se hayan migrado correctamente, valide la exactitud de los datos para ganar confianza. En la consola de tareas de AWS DMS migración, puede encontrar las métricas de datos migrados. Para obtener más información, consulte Verificación de los datos migrados.

También puede utilizar la DataDiffer herramienta Amazon DocumentDB * para validar la coherencia de los datos entre las colecciones de origen y destino.

^{* No es compatible oficialmente con AWS.}

Paso 5: transición de la aplicación

Esto implica cambiar la cadena de conexión de la base de datos de la aplicación para usar el clúster de Amazon DocumentDB.

Para obtener más información sobre cómo conectarse a Amazon DocumentDB, consulte Conexión a Amazon DocumentDB como conjunto de réplicas.

Migración en línea

Una vez finalizada la carga completa de datos, AWS DMS continúa replicando los cambios en curso desde su fuente a Amazon DocumentDB. Una vez que se hayan actualizado los cambios y se hayan completado las comprobaciones de validación de datos, puede hacer una transición a Amazon DocumentDB.

Migración sin conexión

Una vez terminadas las comprobaciones de carga y validación de datos completas, puede hacer la transición a Amazon DocumentDB.

Recursos adicionales

A continuación se presentan algunos recursos adicionales que podrían resultar de utilidad en la migración:

^{* No es compatible oficialmente con AWS.}