Advertencia
Conflictos de importación y exportación de datos con ($) y (.)
A partir de MongoDB 5.0, los nombres de campos de documentos pueden tener como prefijo un carácter de dólar ($) y puede contener un carácter de punto (.). Sin embargo, mongoimport y mongoexport no funcionarán con nombres de campos que usen esos caracteres.
MongoDB Extended JSON v2 no puede diferenciar entre contenedores de tipo y campos que casualmente tienen el mismo nombre que los contenedores de tipo. No utilices formatos Extended JSON en los contextos donde las representaciones BSON correspondientes puedan incluir llaves con el prefijo ($). El mecanismo de DBRef es una excepción a esta regla general.
También existen restricciones en el uso de mongoimport y mongoexport con (.) en los nombres de campo. Dado que los archivos CSV utilizan (.) para representar jerarquías de datos, un (.) en un nombre de campo se interpretará erróneamente como un nivel de anidamiento.
Comportamiento
Fidelidad de tipo
Si necesita preservar todos los tipos de datos complejos de BSON al usar mongoexport para realizar copias de seguridad completas de instancias, especifique JSON extendido v2.0 (modo canónico) en la opción --jsonFormat:
mongoexport --jsonFormat=canonical --collection=<coll> <connection-string>
Si no especificas --jsonFormat, mongoexport genera datos en JSON extendido v2.0 (modo relajado) por defecto.
mongoimport usa automáticamente el formato JSON del archivo de datos de destino especificado al restaurar. Por ejemplo, si el archivo de exportación de datos de destino fue creado por mongoexport con --jsonFormat=canonical especificado, usa el modo canónico.
JSON Format
mongoimport requiere que los datos de importación estén en formato JSON Extendido v2.0 (Canónico) o JSON2 0 Extendido v. (Relajado) de forma predeterminada. Para datos de importación formateados con JSON Extendido v.,1 0especifique la --legacy opción.
Tip
En general, las versiones de mongoexport y mongoimport deben coincidir. Es decir, para importar datos creados desde mongoexport, debe usar la versión correspondiente de mongoimport.
Orden de documentos
Por defecto, mongoimport puede insertar documentos en un orden aleatorio. Para preservar el orden de los documentos durante el proceso de restauración, utilice --maintainInsertionOrder.
Codificación
mongoimport solo admite archivos de datos que estén codificados en UTF-8. El uso de otras codificaciones produce errores.
FIPS
mongoimport crea automáticamente conexiones compatibles con FIPS a mongod/mongos que está configurado para utilizar el modo FIPS
Nivel de confirmación de escritura
Si especificas el nivel de confirmación de escritura (write concern) tanto en la opción --writeConcern como en la opción --uri connection string, el valor --writeConcern anulará el nivel de confirmación de escritura (write concern) especificado en la cadena URI.
agrupar
mongoimport utiliza un tamaño máximo de agrupar de 100,000 para realizar operaciones de inserción masiva/inserción.
Colecciones de series de tiempo
Para importar datos de series temporales, debe crear una colección de series temporales antes de mongoimport ejecutar. mongoimport no permite la creación automática de colecciones de series temporales. Para obtener más información sobre cómo crear una colección,createCollection() consulte.
Acceso requerido
Para conectarse a un que exige mongod autorización con la opción,--auth debe usar las opciones y.--username El usuario que se conecta debe tener,--password readWrite como mínimo, el rol en la base de datos a la que está importando datos.