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. En este artículo se responden las preguntas más frecuentes sobre la extensión de migraciones.
Consulte el error que se muestra en la extensión para ver por qué ocurre el error en la validación. Normalmente, el problema se debe a la incapacidad de conectarse al punto de conexión de MongoDB. El problema también puede surgir porque el usuario no tiene suficientes privilegios en el servidor conectado para ejecutar la evaluación.
Para ejecutar una evaluación, el usuario conectado a MongoDb debe tener los roles readAnyDatabase y clusterMonitor asignados en la instancia de origen.
Use grantRolesToUser para configurar los roles adecuados para el usuario conectado actualmente.
¿Cómo puedo ver los nombres de las colecciones y de las bases de datos de las evaluaciones en la categoría "Compatibilidad de características"?
La valoración usa el comando serverStatus para realizar la valoración de la compatibilidad de características. Como este comando no proporciona los detalles de los nombres de base de datos o colección, la extensión no puede indicar los nombres de los recursos.
Para obtener una valoración más detallada, vuelva a ejecutar la valoración, pero esta vez indique la ruta de acceso a la carpeta que contiene los registros del generador de perfiles de MongoDB en el campo Ruta de acceso a la carpeta de registros.
Puede encontrar el archivo de registro en la ruta de acceso siguiente: /var/log/mongodb/mongodb.log. Si no se encuentra el archivo de registro, compruebe la ubicación en el archivo de configuración de MongoDB.
Para obtener más información, consulte Mensajes de registro de MongoDB.
Una vez iniciada la migración, ¿por qué no puedo ver el recuento exacto de documentos migrados y solo veo una estimación?
Para reducir el uso de recursos en el origen durante la migración, la extensión calcula el número de documentos de cada colección que se va a mover del origen al destino, en lugar de recuperar el recuento exacto.
El núcleo virtual de Azure Cosmos DB for MongoDB no admite series temporales o colecciones agrupadas. Por lo tanto, estos tipos de colecciones faltan o se deshabilitan en el paso de asignación de colecciones.
¿Por qué faltan o se deshabilitan las vistas en el paso de asignación de colecciones cuando el núcleo virtual de Azure Cosmos DB for MongoDB sí admite vistas?
El núcleo virtual de Azure Cosmos DB for MongoDB admite la creación de nuevas vistas. Sin embargo, la extensión de migración no proporciona compatibilidad con la migración de vistas existentes.
Una vez finalizada la migración, siempre puede volver a crear las vistas.
El núcleo virtual de Azure Cosmos DB for MongoDB no comprime los datos en el disco. Una estimación aproximada típica es duplicar el tamaño de almacenamiento que consumen las colecciones de la instancia de MongoDB de origen para calcular el almacenamiento en la cuenta de destino del núcleo virtual de Azure Cosmos DB for MongoDB.
¿Qué colecciones y bases de datos se omiten al migrar de MongoDB al núcleo virtual de Azure Cosmos DB for MongoDB?
Las siguientes bases de datos y colecciones se consideran internas para MongoDB:
| Resource | |
|---|---|
| Bases de datos | admin, local, system config |
| Colecciones | Cualquier colección con el prefijo system. |
Dado que las bases de datos y colecciones internas no son necesarias en el núcleo virtual de Azure Cosmos DB for MongoDB, la extensión no habilita la migración de estas bases de datos.
Este es un problema conocido. La migración no admite bases de datos ni colecciones cuyos nombres comienzan por números.
Cada tarea de migración de Azure Database Migration Service proporciona dos opciones para la migración. Cada opción migra una colección en cualquier momento dado. Por lo tanto, normalmente se migran dos colecciones en paralelo. Una vez completada la migración de una colección, se selecciona automáticamente la siguiente colección. Si tiene muchas colecciones para migrar, cree varias tareas de migración. Cada tarea debe tener un número de colecciones con ámbito para que las migraciones sean más eficaces.
No hay límites en el número de bases de datos y colecciones que se pueden incluir en una sola migración. Sin embargo, las colecciones seleccionadas se dividen en lotes de 50 al crear las tareas de migración en Azure Database Migration Service. Para grandes cantidades de colecciones, verá varias tareas de migración en la lista de migraciones.
Al seleccionar varias colecciones para migrar, el orden en el que estas se migran no es configurable. Si quiere controlar el orden de migración, migre las colecciones en lotes más pequeños en función de la secuencia deseada. Para obtener el mejor rendimiento, evite combinar colecciones más grandes con colecciones más pequeñas en un mismo lote.
¿Cómo debo configurar mi núcleo virtual de Azure Cosmos DB for MongoDB y firewalls de MongoDB para evitar problemas de conectividad?
Agrega excepciones de firewall a la cuenta de destino del núcleo virtual de Azure Cosmos DB for MongoDB para aceptar conexiones de centros de datos globales de Azure. Para obtener más información, consulte Configuración del firewall para Azure Cosmos DB.
Configura la instancia de MongoDB de origen para permitir conexiones desde centros de datos globales de Azure. Para obtener más información, consulte Intervalos de direcciones de IP globales en Azure.
Advertencia
La extensión no admite instancias de MongoDB o de origen habilitadas para puntos de conexión privados. La extensión no admite el entorno de ejecución de integración autohospedado de Azure Database Migration Service.
La base de datos, las colecciones y los índices se crean directamente mediante comandos del cliente local de Azure Data Studio. Esta funcionalidad requiere la conectividad del cliente que ejecuta Azure Data Studio con los entornos de origen y de destino.
Las tareas de migración de datos se ejecutan en Azure Database Migration Service. El servicio de migración es una instancia de servicio de Azure que organiza y realiza actividades de movimiento de datos. Una vez creadas las tareas de migración de datos, no es necesario conectarse a los entornos de origen y de destino.
No hay límites en el número de migraciones que puede crear simultáneamente.
La extensión no admite el cambio de nombre de la base de datos y la colección durante la migración.
Es posible crear varios trabajos de migración, cada uno con un número limitado de colecciones. Este enfoque es un procedimiento recomendado para optimizar la velocidad de las migraciones.
La parte inicial del informe tiene los detalles clave de la ejecución de la valoración, incluido un resumen del entorno de MongoDB de origen. Entre los detalles se incluyen la versión de MongoDB de origen, el tipo de licencia y el tipo de instancia. También contiene una lista de las bases de datos y colecciones evaluadas, con sus respectivos resúmenes de valoración y la preparación para la migración.
Los resultados se agrupan en categorías críticas, advertencias e informativas. Estas categorías le ayudan a priorizar los resultados según su importancia.
Las comprobaciones de evaluación incluyen:
| Descripción | |
|---|---|
| Opciones de la colección | Conclusiones relacionadas con la configuración de la colección no admitida. Algunos ejemplos son las series temporales y las intercalaciones. |
| Características | Conclusiones relacionadas con operadores, sintaxis de consultas o comandos de base de datos no admitidos, incluidas consultas de canalización de agregación. En la columna de detalles adicionales, es posible que vea con qué frecuencia se usaba la característica concreta en el punto de conexión de origen. |
| Límites y cuotas | Conclusiones relacionadas con cuotas y límites específicos del núcleo virtual de Azure Cosmos DB for MongoDB. |
| Índices | Conclusiones relacionadas con las propiedades y los tipos de índice de MongoDB no admitidos. |
| Claves de partición | Conclusiones relacionadas con las configuraciones de la clave de partición no admitidas. |
La extensión almacena errores, advertencias y otros registros de diagnóstico en el directorio de registro predeterminado:
- Windows:
C:\Users\<username>\.dmamongo\logs\ - Linux:
~/.dmamongo/logs - macOS:
/Users/<username>/.dmamongo/logs
Nota
Se crea un archivo de registro independiente para cada día. De manera predeterminada, la extensión almacena los últimos siete archivos de registro.