Introducción
Una guía paso a paso para ayudarte a abrir, configurar y ejecutar una Live Migration en NoSqlStudio — la pantalla que mueve datos hacia MongoDB desde otra fuente (por ejemplo una cuenta de Cosmos DB) con un downtime mínimo. Sigue del Paso 1 hasta el final, en orden. Cada paso te dice qué hacer y qué vas a ver.
Cómo leer este manual
Cada paso tiene:
- Haz — la acción exacta (abrir la pantalla, definir una fuente, ejecutar el assessment).
- Mira — qué debe ocurrir en pantalla. Este es tu “pasa / falla”.
- Por qué — contexto adicional, solo cuando ayuda (sáltalo si vas con prisa).
Antes de empezar
Concepto
Qué es una migración en vivo (online)
Una migración en vivo mueve tus datos mientras la base de origen sigue atendiendo tráfico. En lugar de un dump-and-restore de una sola vez — donde detienes las escrituras, exportas, importas y solo entonces haces el cambio — Live Migration hace una copia bulk completa y luego mantiene el destino sincronizado con las escrituras en curso (CDC) hasta que haces el cutover. Eso reduce el downtime a la breve ventana de cutover, en vez de a la copia entera.
Atención
Ensaya antes de migrar de verdad
Un cutover real redirige una aplicación de producción hacia una nueva base de datos. Ejecuta todo este recorrido contra datos de prueba y un destino desechable primero, para que los pasos y tus verificaciones de “Mira” ya te resulten familiares antes de que algo importe.
Vas a necesitar:
- 1Una conexión activa en NoSqlStudio — Live Migration corre sobre una conexión activa, así que conéctate primero.
- 2Una fuente accesible (por ejemplo una cuenta de Cosmos DB, u otro MongoDB) y un destino MongoDB (autoalojado o Atlas) en el que puedas escribir.
- 3Acceso suficiente en ambos lados: lectura en la fuente, y escritura en la base de destino hacia la que estás migrando.
Tiempo estimado para el recorrido completo: ~15 minutos.
Abrir y conectar
Abre una conexión y trae la pantalla de Live Migration.
Conéctate a un deployment
Conecta NoSqlStudio a un deployment activo usando tu connection string — por ejemplo mongodb+srv://<user>:<password>@<cluster-host>/.
La conexión se abre y aparece en la barra lateral.
Live Migration es parte de las herramientas DataOps de Schema & Data, y todas ellas necesitan una conexión activa para funcionar.
Abre Live Migration
Desde la pantalla Home abre la tarjeta Schema & Data, o usa el menú Tools ▸ Schema & Data ▸ Live Migration (atajo de teclado Ctrl+Alt+Y).
La pantalla 🚚 Live Migration se abre por sí sola — a diferencia de Copy, Compare y Data Mask, no forma parte del contenedor Data Operations; es su propia pantalla dedicada.
Concepto
Por qué una pantalla propia
Copy, Compare y Mask son operaciones de una sola pasada que conviven en un contenedor Data Operations con pestañas. Una migración es un trabajo más largo y multifase — assess → bulk → CDC sync → cutover — así que tiene una pantalla propia para mostrar el progreso en cada fase.
Configurar fuente y destino
Elige la fuente
En la configuración de fuente, elige de dónde vienen los datos — por ejemplo una conexión de Cosmos DB.
La fuente queda definida y Live Migration la muestra como el origen de la migración.
Live Migration está hecho para mover datos hacia dentro de MongoDB desde otro sistema; Cosmos DB es una fuente común, pero el mismo flujo se aplica a cualquier origen soportado.
Elige el destino
En la configuración de destino, elige el deployment MongoDB hacia el que estás migrando — tu clúster autoalojado o un clúster Atlas.
El destino queda definido, y ahora tienes ambos extremos — fuente y destino — conectados.
Concepto
Eligiendo el alcance
Antes de ejecutar nada, sé deliberado sobre qué estás migrando — la instancia entera, una sola base o colecciones específicas. Un alcance estrecho y bien entendido es más fácil de evaluar, más rápido de copiar y más simple de verificar tras el cutover.
Assess
Ejecuta el assessment
Con la fuente y el destino configurados, ejecuta el assessment — la primera fase del flujo.
Live Migration produce un informe de qué se va a migrar y de cualquier hallazgo de compatibilidad entre la fuente y el destino.
Lee los hallazgos
Revisa el assessment antes de continuar: te dice qué bases y colecciones están en el alcance y expone cualquier cosa que pueda necesitar atención en el camino hacia MongoDB.
Concepto
Por qué evaluar primero
El assessment es un ensayo de entendimiento: inventaría lo que se va a mover y señala incompatibilidades antes de que copies un solo byte. Encontrar un problema en el informe es barato; encontrarlo a mitad de un bulk de varios gigabytes no lo es.
Bulk load
Inicia la copia bulk
Inicia la fase bulk para copiar los datos existentes desde la fuente hacia el destino.
Aparece progreso en vivo mientras corre la copia bulk — puedes ver cómo avanza por los datos.
Míralo completarse
La fase bulk recorre los datos en alcance y reporta su progreso hasta completarse.
Concepto
Qué significa bulk
El bulk es la copia completa inicial — un snapshot point-in-time de todo lo que actualmente está en alcance, movido al destino. Es el trabajo pesado de la migración. Las escrituras que llegan a la fuente mientras (y después de que) corre el bulk las maneja la siguiente fase, no esta.
CDC sync
Mantén el destino al día con la fuente mientras la aplicación sigue escribiendo.
Mira el CDC sync
Después de que el bulk se completa, mira la fase CDC sync mientras transmite los cambios en curso desde la fuente al destino.
El destino se mantiene en sincronía con la fuente: inserts, updates y deletes que siguen ocurriendo en la fuente se aplican continuamente en el destino, y el lag entre ambos tiende a cero.
Concepto
Qué es el CDC
CDC — change data capture — observa el stream de cambios de la fuente y los reaplica en el destino. El bulk te da un snapshot; el CDC mantiene ese snapshot fresco, para que la aplicación pueda seguir en vivo sobre la fuente todo el tiempo que duren la copia y la puesta al día.
Mantén la fuente accesible
Cutover
Haz el cutover cuando el lag esté ~cero
Cuando el lag del CDC esté en o cerca de cero, orquesta el cutover — la fase final — para cambiar la aplicación al destino.
La migración completa el cutover y el destino pasa a ser la base de datos que tu aplicación usa ahora.
Concepto
Minimizando el downtime
El cutover es el único momento que necesita una pausa real. Como el bulk y el CDC ya hicieron el trabajo, la fuente y el destino están casi idénticos al momento de cambiar — así que el downtime es solo la breve ventana de cambio, no la copia entera. Ese es todo el propósito de una migración online.
Verifica el resultado
Tras el cutover, verifica que el destino coincida con la fuente usando Compare Databases (Ctrl+Alt+Shift+C) — selecciona los dos lados y revisa el diff estructural.
Compare reporta las diferencias (idealmente ninguna de fondo) para que puedas confirmar que la migración trajo todo lo que esperabas.
Una migración solo está terminada cuando puedes probar que el destino es correcto. Compare te da esa evidencia en lugar de una corazonada.
Limpieza (cuando termines)
Detén o cierra la migración cuando el cutover esté completo (o para abandonar un ensayo), luego cierra la pantalla de Live Migration.
El trabajo de migración termina y la pantalla se cierra limpiamente.
Atención
Un cutover real es un cambio de producción — reapunta una aplicación en vivo hacia una nueva base de datos. Ensaya todo el flujo sobre datos de prueba primero, y ejecuta el cutover de producción solo después de que cada “Mira” de este manual haya coincidido en tu ensayo.
Resumen de lo que validaste
| Etapa | Funcionalidad |
|---|---|
| 1 | Abrir Live Migration en su propia pantalla (Ctrl+Alt+Y) sobre una conexión activa |
| 2 | Configurar la fuente (p. ej. Cosmos DB) y el destino MongoDB/Atlas, y elegir un alcance |
| 3 | Ejecutar el assessment y leer sus hallazgos de compatibilidad antes de copiar |
| 4 | Iniciar el bulk load y ver el progreso de la copia completa inicial |
| 5 | Ver el CDC sync mantener el destino al día con las escrituras en curso en la fuente |
| 6 | Orquestar el cutover con lag ~cero y verificar con Compare Databases |