Las tareas de migración son los procesos de trabajo responsables de transferir tus datos y esquemas desde una base de datos relacional a MongoDB. Cree una nueva tarea de migración desde el Data Migration tab.
Acerca de esta tarea
Las credenciales URI que proporcionas cuando creas una tarea de migración no necesitan ser las mismas que las credenciales que utilizaste cuando creaste tu Proyecto.
Puedes usar un Conexión de base de datos relacional, o crea una cuando crees la tarea de migración.
Antes de comenzar
Crea una o más reglas de mapeo en tu proyecto de Relational Migrator.
Tanto para las implementaciones en Atlas como on-premises, crea un usuario de MongoDB independiente para Relational Migrator con
readWriteacceso a su base de datos MongoDB.Si está utilizando un driver JDBC para realizar una migración de snapshot, contacte a su representante de MongoDB para obtener información de configuración.
Pasos
Ingrese los detalles de la conexión a la base de datos relacional
En el formulario Connect to your source database, introduce los detalles de la conexión para crear el URI JDBC de tu base de datos relacional.
Para utilizar una conexión de base de datos relacional guardada, haz clic en Use a saved connection y selecciónala en el menú desplegable, luego introduce las credenciales si es necesario.
Para crear una nueva conexión:
En el menú desplegable Database type, selecciona el tipo de base de datos.
Para introducir una cadena de conexión directamente, active el Enter URI manually y pegue su cadena de conexión en el JDBC URI.
Para crear una cadena de conexión ingresando la información de la base de datos, ingresa lo siguiente:
CampoValorHost
La IP o nombre DNS del host.
Port
El número de puerto.
Database
El nombre de la base de datos. Obligatorio.
Identifier
Uno de Service Name o SID.
Username y Password
Las credenciales que se deben usar para la autenticación.
Al seleccionar Save password, la contraseña se guarda de forma segura en su máquina, por lo que no tiene que ingresar la Username y la Password nuevamente al utilizar la conexión guardada.
CampoValorHost
La IP o nombre DNS del host.
Port
El número de puerto.
Database
El nombre de la base de datos. Si está en blanco, solo se verán los objetos en el esquema por defecto
dboen todas las bases de datos.Authentication
Por defecto, esto se establece en SQL Server. Establezca en Windows para habilitar la Autenticación integrada de Windows, utilizando las credenciales del usuario que inició el ejecutable de Relational Migrator. Esto desactiva los campos Username y Password.
Username y Password
Las credenciales que se deben utilizar para la autenticación. Desactivado si Authentication está configurado en Windows.
Al seleccionar Save password, la contraseña se guarda de forma segura en su máquina, por lo que no tiene que ingresar la Username y la Password nuevamente al utilizar la conexión guardada.
General / SSL toggle
Ver la configuración de SSL para la conexión.
Para utilizar SSL, primero debes descomentar y actualizar las propiedades de configuración
server.sslen el archivo.user.propertiesSSL: Use SSL
Activar o desactivar SSL.
SSL: Trust server certificate
Con el SSL habilitado, marque esto para confiar en el certificado almacenado. Deja sin marcar para verificar el certificado del servidor con una Autoridad de Certificación de confianza.
CampoValorHost
La IP o nombre DNS del host.
Port
El número de puerto.
Database
El nombre de la base de datos. Deja en blanco para cargar todas las bases de datos.
Username y Password
Las credenciales que se deben usar para la autenticación.
Al seleccionar Save password, la contraseña se guarda de forma segura en su máquina, por lo que no tiene que ingresar la Username y la Password nuevamente al utilizar la conexión guardada.
General / SSL toggle
Ver la configuración de SSL para la conexión.
Para utilizar SSL, primero debes descomentar y actualizar las propiedades de configuración
server.sslen el archivo.user.propertiesSSL: Use SSL
Activar o desactivar SSL.
SSL: SSL mode
Si tienes SSL habilitado, elige entre:
Preferred (por defecto): Haz una conexión cifrada si es posible, de lo contrario pasar a una conexión no cifrada.
Required: Requerir una conexión cifrada.
Verify CA: Verifica el certificado del servidor con una Autoridad Certificadora de confianza.
Verify identity: Verifica la información de conexión a la base de datos con el contenido del certificado.
CampoValorHost
La IP o nombre DNS del host.
Port
El número de puerto.
Database
El nombre de la base de datos. Dejar en blanco para conectarse a la base de datos por defecto.
Username y Password
Las credenciales que se deben usar para la autenticación.
Al seleccionar Save password, la contraseña se guarda de forma segura en su máquina, por lo que no tiene que ingresar la Username y la Password nuevamente al utilizar la conexión guardada.
General / SSL toggle
Ver la configuración de SSL para la conexión.
Para utilizar SSL, primero debes descomentar y actualizar las propiedades de configuración
server.sslen el archivo.user.propertiesSSL: Use SSL
Activar o desactivar SSL.
SSL: SSL mode
Si tienes SSL habilitado, elige entre:
Prefer (por defecto): Haz una conexión cifrada si es posible, de lo contrario pasar a una conexión no cifrada.
Require: Requerir una conexión cifrada.
Verify CA: Verifica el certificado del servidor con una Autoridad Certificadora de confianza.
Verify full: Verifica la información de conexión a la base de datos con el contenido del certificado.
Introduce un Connection name y un Environment tag opcional.
Haga clic en Connect.
La conexión guardada está disponible para su uso en todas las tareas y proyectos.
Ingrese los detalles de conexión de MongoDB
Para usar una conexión guardada de MongoDB, haz clic en Use a saved connection y seleccionala del menú desplegable, luego introduce las credenciales si se requieren.
Para crear una nueva conexión:
Introduce la cadena de conexión de MongoDB.
En MongoDB connection string (URI), introduce tu URI de MongoDB.
Si usa X.509 autenticación, Relational Migrator verifica la sintaxis de la cadena de conexión y el formato del archivo de certificado.
Si no está incluido en la cadena de conexión, introduce el Database para conectar.
Si no se incluyen en la cadena de conexión y no se utiliza la autenticación X.509, introduzca el Username y Password de su Relational Migrator usuario MongoDB.
Introduce un Connection name y un Environment tag opcional.
Haga clic en Connect.
La conexión guardada está disponible para su uso en todas las tareas y proyectos.
En el formulario Migration Options, selecciona Migration Options:
Opción de migración | Descripción |
|---|---|
Elimine las colecciones de destino antes de la migración | booleano. Indica si Relational Migrator descarta una colección de destino antes de transferir datos. |
Detener después de errores | Entero. Indica el número de errores después de los cuales Relational Migrator detiene la tarea de migración. |
Verifica los datos migrados | booleano. Si es verdadero, el motor de sincronización verifica los datos migrados frente a la base de datos de origen. Solo es compatible con el modo de snapshot. |
Truncamiento de datos | Enum. Controla cómo Relational Migrator maneja los problemas de truncamiento durante la migración. |
Cuando se configura el Mode, el Relational Migrator comprueba si la base de datos está configurada correctamente. Si encuentra problemas, muestra un aviso de advertencia y un botón Generate Script para descargar un script SQL. Este script incluye las declaraciones de configuración requeridas y cualquier instrucción adicional como comentarios.
Advertencia
Antes de iniciar una tarea de migración:
Descarga el script.
Revise cuidadosamente su contenido.
Ejecute las instrucciones.
Sigue cualquier paso manual comentado.
(Opcional) Indique las colecciones para migrar en una migración selectiva.
Si deseas migrar solo un subconjunto de colecciones en tu proyecto, haz clic en Selective Migrations y elige las colecciones que deseas migrar. Si desea migrar todas las colecciones en su base de datos, omita este paso.
Las pestañas a continuación explican las diferentes formas en que puedes seleccionar colecciones para migrar:
En Selective migration, utiliza las marcas de verificación para seleccionar colecciones:
Todas las colecciones dentro de una base de datos: Haz clic en la marca de verificación de la base de datos.
Colecciones específicas dentro de una base de datos: Expanda la base de datos y seleccione colecciones individuales.
Cambiar a Bulk Selection.
Pega o escribe una lista separada por comas de nombres de colecciones. Por ejemplo,
collection1,collection2.Mientras escribes, Relational Migrator filtra la lista y te permite hacer clic en las colecciones que coincidan para incluirlas o excluirlas.
Revise y comience su tarea de migración
En el formulario Review Summary, revisa los siguientes detalles antes de empezar tu tarea de migración:
Tipo: el modo de migración.
Tablas y filas afectadas: El número de tablas y filas incluidos en la migración.
Tamaño estimado de los datos: El tamaño aproximado de los datos a migrar.
Eliminar colecciones de destino: Si Relational Migrator descarta las colecciones antes de la migración.
Detener la migración después de: El número de errores después del cual se detiene la migración.
Colecciones para migrar: Las colecciones incluidas en esta migración.
Para iniciar tu tarea de migración, haz clic en Start.
Importante
Para grandes trabajos de migración a un clúster de Atlas, el Resumen de revisión puede incluir Atlas Performance Suggestions que recomienden niveles de clúster más altos. La actualización es opcional, pero reduce el tiempo de migración.
Haga clic en Upgrade on Atlas para abrir Atlas en una nueva pestaña o ventana del navegador. Si desea actualizar, pero no tiene los permisos necesarios, póngase en contacto con su administrador.
Próximos pasos
Obtén más información
Para obtener información detallada sobre los requisitos de configuración para cada base de datos, consulte lo siguiente: