Compartir a través de

Extensión de migración de Azure Cosmos DB for MongoDB para Azure Data Studio (versión preliminar)

  • Artículo

La extensión de migración de Azure Cosmos DB para MongoDB le ayuda a migrar cargas de trabajo de MongoDB a Azure Cosmos DB. Puede usar esta extensión para lo siguiente:

  • Ejecute una valoración integral en la carga de trabajo y descubra las acciones necesarias para migrar sus cargas de trabajo al núcleo virtual de Azure Cosmos DB for MongoDB.
  • Realice la operación de migración con bases de datos y colecciones seleccionadas al núcleo virtual de Azure Cosmos DB for MongoDB.

Importante

Actualmente, esta extensión no admite los escenarios siguientes:

  • Migración en la que la cuenta de origen o de destino está habilitada para el punto de conexión privado.
  • Migraciones en línea y sin conexión de Azure Cosmos DB for MongoDB para RU.

Para obtener más información sobre las soluciones alternativas para la API para el núcleo virtual de MongoDB, consulte opciones de migración.

Requisitos previos

  • Una cuenta existente de núcleos virtuales de Azure Cosmos DB for MongoDB.
  • Última versión de Azure Data Studio.
  • MongoDB que ejecute la versión 3.2 o posterior.
  • Agrega excepciones de firewall a la cuenta de destino del núcleo virtual de Azure Cosmos DB for MongoDB y MongoDB de origen para aceptar conexiones de centros de datos globales de Azure.

Preparación

Antes de iniciar la migración, es necesario llevar a cabo por adelantado el planeamiento y la toma de decisiones sobre la migración antes de mover realmente los datos.

Instale la extensión

Instale la extensión de migración de Azure Cosmos DB para MongoDB en Azure Data Studio antes de comenzar la migración.

  1. Abra el administrador de extensiones en Azure Data Studio. Seleccione el icono de extensiones o bien Extensiones en el menú Vista.

  2. Escriba Cosmos en la barra de búsqueda

  3. Seleccione la extensión Migración de Azure Cosmos DB para MongoDB y consulte los detalles.

    Captura de pantalla en la que se muestra el botón de instalación de la extensión de migración de Azure Cosmos DB for MongoDB.

  4. Seleccione Instalar.

Configurar los valores de la extensión

Puede configurar algunas opciones de la extensión después de instalarla. Este paso es opcional. Si no se configura explícitamente ninguna configuración, la extensión usa la configuración predeterminada.

  1. Vaya a las extensiones y seleccione Migración de Azure Cosmos DB para MongoDB, seleccione el icono Administrar configuración y, luego, seleccione Configuración de extensión.

    Captura de pantalla de la selección de configuración de la extensión.

  2. En la configuración de esta extensión, proporcione el Assessment path para cambiar la ubicación en la que se almacenan los metadatos de la valoración. Si se deja en blanco, se usa la ubicación predeterminada.

Conexión al origen de MongoDB

Use la extensión por primera vez para conectarse a la instancia de origen de MongoDB existente. Asegúrese de tener las credenciales de conexión para el origen listas antes de iniciar esta sección.

  1. Busque el icono de conexiones en la barra de menús y seleccione Nueva conexión.

    Captura de pantalla de la barra de menú de conexiones de la extensión.

  2. En el panel Conexión, rellene los siguientes campos:

    Valor
    Tipo de conexión Azure Cosmos DB for MongoDB
    Cadena de conexión/Parámetros Use los parámetros o cadena de conexión para su instancia de MongoDB de origen actual.
    Grupo de servidores Default
    Nombre (opcional) Proporcione un nombre único para esta conexión.

  3. Seleccione Conectar.

  4. Abra el menú contextual de la nueva conexión en el panel Conexiones. A continuación, seleccione Administrar.

    Captura de pantalla de la pantalla Administrar base de datos.

  5. Seleccione Migración de Azure Cosmos DB.

    Captura de pantalla de la pantalla de la base de datos de valoración de migración.

Ejecución de una evaluación

La evaluación examina el patrimonio de datos y el uso actuales de MongoDB. Entonces, la característica de evaluación genera un informe completo que le ayuda a identificar las acciones necesarias que se deben adoptar antes de migrar las cargas de trabajo a Azure Cosmos DB para MongoDB.

  1. Busque y vaya a la pestaña Panel. A continuación, seleccione Evaluar y migrar bases de datos.

    Captura de pantalla de la pestaña Panel dentro de la característica de migración de la extensión.

  2. Complete el asistente para proporcionar detalles a la extensión para que pueda realizar una evaluación.

    Captura de pantalla de los detalles de la valoración antes de validar las credenciales.

    1. En el campo Nombre de la valoración, escriba un título.

    2. Seleccione la cuenta de Azure Cosmos DB de destino para la cuenta de MongoDB en la lista desplegable Oferta .

    3. Indique la ruta de acceso a los registros de MongoDB.

      Sugerencia

      Este es un campo opcional, pero especificar la ruta de acceso a los registros permite obtener conclusiones más detalladas en el nivel de colección. Si no se especifica la carpeta de registro, la herramienta usa detalles del comando serverStatus para llevar a cabo la valoración.

      El comando serverStatus devuelve el uso de características solo desde el último reinicio, por lo que tendría que asegurarse de que haya transcurrido el tiempo suficiente desde el último reinicio del servidor para obtener una valoración que refleje exactamente su carga de trabajo.

    4. Proporciona la ruta de acceso a los registros de valoración de datos.

      Sugerencia

      Aunque este campo es opcional, proporcionar registros de evaluación de datos puede proporcionar información más detallada sobre la carga de trabajo. Estos registros se obtienen mediante el examen de datos y la lectura de registros detallados. La evaluación de datos se ejecuta de forma independiente como una CLI antes de iniciar la valoración de la migración y el JSON resultante se proporciona posteriormente aquí. Descarga la CLI de valoración de datos aquí.

    5. Seleccione Ejecutar validación para validar las entradas de la valoración.

  3. Si la validación se realiza correctamente, seleccione Iniciar valoración para ejecutar la valoración.

    Captura de pantalla de los detalles de la valoración después de validar las credenciales.

  4. Según el tamaño del servidor de origen, la valoración tarda unos minutos. Antes de continuar, espere a que se complete la valoración.

    Captura de pantalla de una nueva valoración en curso.

  5. Una vez completada la valoración, debería tener un informe de evaluación.

    Captura de pantalla del nuevo informe de valoración de la instancia de MongoDB de origen.

  6. En el informe de evaluación, seleccione el nombre de la instancia para revisar una lista de problemas de todo el servidor. Seleccione una base de datos específica para ver los problemas que solo son aplicables a la base de datos seleccionada.

    Captura de pantalla del nuevo informe de valoración de la base de datos seleccionada de MongoDB de origen.

  7. Seleccione Descargar informe para obtener un informe descargable consolidado.

  8. Estudie el informe de evaluación para identificar las acciones que debe realizar para una migración sin problemas de sus cargas de trabajo en Azure Cosmos DB para MongoDB. Antes de ir al paso siguiente, asegúrese de solucionar todos los problemas de bloqueo notificados en la evaluación. Si hay algún problema sin resolver, puede salir del proceso y resolverlo más adelante. Una vez resueltos los problemas, puede volver y reanudar el proceso de evaluación y migración.

Realización de una migración

En este paso, use el informe de evaluación para realizar una migración sin conexión de sus datos desde la instancia de MongoDB de origen a su cuenta de Azure Cosmos DB for MongoDB para el núcleo virtual de destino.

  1. En la pantalla del informe de evaluación, seleccione todas las bases de datos que planee migrar. Después, seleccione Siguiente.

    Captura de pantalla de la base de datos seleccionada para la migración.

  2. Restrinja las listas para seleccionar la cuenta de Azure Cosmos DB para MongoDB de destino mediante el filtrado por suscripción y, a continuación, el grupo de recursos. A continuación, proporcione las credenciales de conexión necesarias para conectarse a la cuenta.

    Captura de pantalla de la selección de una cuenta de Azure Cosmos DB for MongoDB de destino.

  3. Seleccione Probar conexión para validar las credenciales de la cuenta de Azure Cosmos DB para MongoDB. Seleccione Siguiente para ir a la asignación de colecciones desde el origen al destino.

  4. Elija Omitir o Migrar para cada colección de la lista de asignaciones. Las colecciones que ya existen en el destino se marcan automáticamente con un icono y se establecen en Omitir de forma predeterminada. Seleccione la opción Siguiente para configurar Azure Database Migration Service (DMS).

    Captura de pantalla de la asignación de colecciones del origen al destino.

    Advertencia

    Si opta por Migrar una colección existente, se sobrescribirá toda la colección, lo que provocará una pérdida de datos irrecuperable. Tenga cuidado al elegir esta opción.

  5. Elija una instancia de Azure Database Migration Service existente en la lista desplegable o seleccione Crear nuevo para crear un nuevo servicio de migración. Azure Database Migration Service es un servicio que migra datos a y desde plataformas de datos de Azure mediante la infraestructura en la nube para la transferencia de datos, en lugar de depender de recursos locales.

    Captura de pantalla de la opción para elegir un servicio de migración.

  6. Seleccione el modo de migración más adecuado para su caso de uso.

    • La migración en línea copia los datos de recopilación, lo que garantiza que las actualizaciones también se replican durante el proceso. Este método es ventajoso con un tiempo de inactividad mínimo, lo que permite operaciones continuas para la continuidad empresarial. Use esta opción cuando las operaciones en curso sean cruciales y reducir el tiempo de inactividad sea una prioridad.
    • La migración sin conexión captura una instantánea de la base de datos al principio, lo que ofrece un enfoque más sencillo y predecible. Funciona bien cuando la utilización de una copia estática de la base de datos es aceptable y las actualizaciones en tiempo real no son esenciales.

  7. Seleccione Siguiente para ver el resumen de la migración. Una vez que haya revisado y confirmado los detalles, seleccione Crear esquema para crear recursos en la cuenta de destino.

    Captura de pantalla de la opción para ver el resumen de la migración.

  8. Seleccione Iniciar migración para iniciar la transferencia de datos mediante el servicio de migración seleccionado.

    Captura de pantalla de la opción para iniciar una migración mediante el servicio de migración.

  9. En el menú emergente Confirmar configuración, compruebe que la configuración del firewall cumple los requisitos. Seleccione Aceptar para confirmar.

    Captura de pantalla del menú emergente Confirmar configuración para comprobar la configuración del firewall.

Las tareas de migración de datos se ejecutan en Azure Database Migration Service, por lo que no es necesario conectarse a los entornos de origen y de destino durante la migración de datos. El estado se actualiza en el panel a intervalos frecuentes.

Nota:

Si ha seleccionado más de 50 colecciones para migrar, el trabajo de migración se procesará por lotes en varios trabajos en el servicio de migración, cada uno de los cuales contiene un máximo de 50 colecciones.

  1. Supervise el estado de la migración en la página del panel una vez inicializados los trabajos.

    Captura de pantalla del panel con el estado de la migración.

  2. Seleccione una migración específica en la lista de migraciones para ver más detalles.

Supervisión de migraciones sin conexión

El estado se actualiza automáticamente una vez finalizadas todas las tareas de migración de datos.

Captura de pantalla de colecciones con el estado de la migración.

Una vez que los datos se copian correctamente del origen al destino, el estado de las migraciones sin conexión indica que se ha realizado correctamente.

Captura de pantalla de estado de migración realizada con éxito.

  • Cambie la cadena de conexión de las aplicaciones para que apunte a la cuenta de destino.

Supervisión de migraciones en línea

Las migraciones en línea, a diferencia de las migraciones sin conexión, no se completan automáticamente. En su lugar, se ejecutan continuamente hasta que se finalizan manualmente seleccionando Transición.

Captura de pantalla del estado de la migración en línea.

Para completar la migración en línea, siga estos pasos en el orden indicado:

  1. El botón Transición se habilita una vez completada la carga inicial de datos para todas las colecciones. La migración se encuentra actualmente en la fase de replicación, copiando continuamente las actualizaciones de la instancia de origen a la instancia de destino para mantenerla actualizada con los cambios más recientes.

  2. Cuando esté listo para realizar la transición de migración, detenga todas las transacciones entrantes en las colecciones de origen que se van a migrar.

  3. Supervise los cambios de replicación en la tabla y espere hasta que se estabilice la métrica "Cambios de replicación reproducidos". Una métrica estable "Cambios de replicación reproducidos" indica que todas las actualizaciones del origen se copian correctamente en el destino.

  4. Seleccione Transición cuando la brecha de replicación sea mínima para todas las recopilaciones y la métrica "Cambios de replicación reproducidos" sea estable.

  5. Valide manualmente que el recuento de filas sea el mismo entre las colecciones de origen y de destino.

  6. En el cuadro de diálogo emergente. Seleccione Completar transición.
    Captura de pantalla de la ventana emergente de la transición de la migración en línea.

    Nota:

    La realización de la operación de transición sin validar que el origen y el destino se sincronizan puede provocar la pérdida de datos.

  7. Espere a que el estado cambie a Realizado correctamente.

  8. Actualice la cadena de conexión de las aplicaciones para que apunte a la cuenta de destino.

Visualización de migraciones y evaluaciones anteriores

A menudo resulta útil revisar las evaluaciones y migraciones anteriores. La extensión proporciona una interfaz para revisar los resúmenes de la evaluación y las migraciones anteriores. La extensión también ofrece la capacidad de revisar informes detallados de evaluación histórica.

  1. Para ver las migraciones anteriores, seleccione la pestaña Migraciones de la barra de herramientas. La lista de migraciones contiene todas las migraciones que se iniciaron en la máquina actual. Puede seleccionar una migración específica en la lista para obtener más detalles.

    Captura de pantalla de la lista de todas las migraciones creadas con la extensión.

  2. Para ver las evaluaciones anteriores, seleccione la pestaña Evaluaciones de la barra de herramientas. La lista de evaluaciones contiene todas las evaluaciones que se iniciaron en el equipo actual.

    Captura de pantalla de la lista de todas las evaluaciones realizadas con la extensión.

Paso siguiente

Consulte las preguntas más frecuentes sobre la extensión de migración de Azure Cosmos DB para MongoDB