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.
¿Cómo se ejecuta mi evaluación si se produce un error en el paso de la ejecución de la validación?
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.
¿Cómo recopilo los mensajes de registro?
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.
¿Por qué faltan o se deshabilitan algunas colecciones en el paso de asignación de colecciones?
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.
¿Cuánto almacenamiento tengo que usar en la cuenta de destino después de la migración?
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.
¿Es posible migrar bases de datos y colecciones cuyos nombres comienzan por números?
Este es un problema conocido. La migración no admite bases de datos ni colecciones cuyos nombres comienzan por números.
Si selecciono varias colecciones para migrar, ¿se migran en paralelo?
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.
¿Cuántas bases de datos y colecciones puedo migrar en una sola migración?
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.
¿Cómo debo planear el orden y la cantidad de colecciones que se van a migrar?
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.
¿Cómo debo configurar los firewalls del servidor de origen para evitar problemas de conectividad?
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.
¿Los trabajos de migración se ejecutan localmente en mi máquina?
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.
¿Cuántas migraciones puedo ejecutar simultáneamente?
No hay límites en el número de migraciones que puede crear simultáneamente.
¿Puedo cambiar el nombre de las bases de datos y las colecciones durante la migración?
La extensión no admite el cambio de nombre de la base de datos y la colección durante la migración.
¿Puedo migrar las colecciones a través de varias iteraciones de 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.
¿Qué se incluye en un informe de evaluación?
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. |
¿Qué tipo de registros crea la extensión?
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.