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

Artículo
04/22/2024

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:

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

Importante

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

Migración en línea para el núcleo virtual de Azure Cosmos DB for MongoDB.
Migraciones en línea y sin conexión de Azure Cosmos DB para RU de MongoDB.

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.
- Si no tiene una suscripción de Azure, cree una cuenta gratuita.
Última versión de Azure Data Studio.
MongoDB que ejecute la versión 3.2 o posterior.

Preparació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.

Para obtener más información sobre la planificación de la migración previa para la API de núcleo virtual de MongoDB, consulte los pasos de premigración de núcleo virtual de Azure Cosmos DB para MongoDB.
Para obtener más información sobre la planificación de la migración previa para la API para RU de MongoDB, consulte los pasos de premigración de Azure Cosmos DB para RU de MongoDB.

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.

Abra el administrador de extensiones en Azure Data Studio. Seleccione el icono de extensiones o bien Extensiones en el menú Vista.
Escriba Cosmos en la barra de búsqueda
Seleccione la extensión Migración de Azure Cosmos DB para MongoDB y consulte los detalles.
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.

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.
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.

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

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.

Seleccione Conectar.
Abra el menú contextual de la nueva conexión en el panel Conexiones. A continuación, seleccione Administrar.
Seleccione Migración de Azure Cosmos DB.

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.

Busque y vaya a la pestaña Panel. A continuación, seleccione Evaluar y migrar bases de datos.
Complete el asistente para proporcionar detalles a la extensión para que pueda realizar una evaluación.
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
  
  Se trata de un campo opcional; proporcionar la ruta de los registros ofrece información más detallada a nivel de colección. Si no se especifica la carpeta de registro, la herramienta usa la información del comando serverStatus para llevar a cabo la valoración. Ten en cuenta que el comando «serverStatus» notifica el uso de características solo desde el último reinicio del servidor. Para obtener una valoración que refleje con precisión la carga de trabajo real, asegúrate de que ha transcurrido tiempo suficiente desde el último reinicio del servidor.
4. Proporciona la ruta de acceso a los registros de valoración de datos.
  
  Sugerencia
  
  Aunque este campo sigue siendo opcional, los registros de valoración de datos pueden ofrecer información más completa sobre la carga de trabajo. Estos registros se adquieren mediante el examen de datos y la revisión de registros detallados. La evaluación de datos se ejecuta de forma independiente como una interfaz de la línea de comandos (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.
Si la validación se realiza correctamente, seleccione Iniciar valoración para ejecutar la valoración.
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.
Una vez completada la valoración, debería tener un informe de evaluación.
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.
Seleccione Descargar informe para obtener un informe descargable consolidado.
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 sin conexió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 para el núcleo virtual de MongoDB de destino.

En la pantalla del informe de evaluación, seleccione todas las bases de datos que planee migrar. Después, seleccione Siguiente.
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.
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.
Importante

Actualmente, la extensión no admite instancias de MongoDB o de origen habilitadas para puntos de conexión privados.
- Configura la instancia de MongoDB de origen para permitir conexiones desde centros de datos globales de Azure.
- Agrega excepciones de firewall a la cuenta de destino del núcleo virtual de Azure Cosmos DB for MongoDB para permitir conexiones de centros de datos globales de Azure.
- Para buscar la información del intervalo IP pertinente, descarga JSON desde intervalos globales de direcciones IP de Azure y busca «AzureCloud.{ Región de la cuenta de Cosmos DB de destino}» dentro del archivo JSON.
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).

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.
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.

Importante

Si es la primera vez que usa Database Migration Service, asegúrese de que el proveedor de recursos Microsoft.DataMigration esté registrado en su suscripción.
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.
Seleccione Iniciar migración para iniciar la transferencia de datos mediante el servicio de migración seleccionado.
Consulte el estado de la migración en la página del panel una vez inicializados los trabajos.
Seleccione una migración específica en la lista de migraciones para ver más detalles. Antes de continuar, espere a que se complete la migración.

Nota:

No es necesario mantenerse conectado al servicio de migración ni a Azure Data Studio mientras los trabajos de migración se ejecutan de forma remota y asincrónica. Los trabajos de migración se ejecutan en el servicio de migración y el estado se actualizará en el panel a intervalos frecuentes.

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.
Una vez completado el trabajo, el estado de migración indica que se ha realizado correctamente.

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.

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.
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.