Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Cargar datos en un clúster Atlas Infinite

Para cargar sus propios datos en un clúster Atlas Infinite, utilice uno de los siguientes métodos:

  • mongodump y mongorestore: mongodump crea una exportación binaria de los datos de un MongoDB autónomo o set de réplicas existente, incluido un clúster Atlas Core, y mongorestore carga los datos en un clúster Atlas Infinite. Utilice este método cuando sus datos de origen estén en una implementación de MongoDB. Para aprender cómo, consulta restauración de datos de una implementación de MongoDB.

  • mongoimport: mongoimport carga documentos desde un archivo JSON o CSV en un clúster Atlas Infinite. Utilice este método cuando sus datos de origen estén en un archivo externo a MongoDB. El archivo puede provenir de mongoexport o de una herramienta de exportación de terceros. Para aprender cómo, consulte Importar datos de un archivo JSON o CSV.

  • Operaciones de escritura masiva: Los métodos de base de datos de MongoDB guardan lotes de documentos en un clúster Atlas Infinite. Utilice este método cuando genere o transforme los documentos usted mismo desde una aplicación, mongosh, Atlas Interfaz de Usuario, o desde otra interfaz. Para aprender cómo, consulte Guardar datos que genere.

Cada uno de estos métodos consume capacidad de guardar en el clúster Atlas Infinite de destino. Para limitar el efecto en sus aplicaciones, ejecute grandes cargas de datos durante el uso del sistema fuera de las horas pico o un periodo de mantenimiento programado.

Complete los siguientes requisitos previos:

mongodump crea una exportación binaria de un MongoDB autónomo o set de réplicas existente, y mongorestore carga esa exportación en un clúster Atlas Infinite. La exportación incluye datos, metadatos e índices de la implementación de origen. Para obtener orientación sobre cómo copiar datos desde un clúster particionado de MongoDB existente, consulta la solicitud de soporte.

También puede utilizar este procedimiento para migrar datos desde un clúster gratuito o un clúster Flex en Atlas Core a un clúster dedicado en Atlas Infinite. Para escalar un clúster gratuito o un clúster Flex in situ en lugar de migrar datos, consulte Escalar un clúster gratuito o un clúster Flex a un clúster dedicado.

Este procedimiento requiere tiempo de inactividad. Detenga las operaciones de guardar en su implementación de origen, ejecute mongodump y mongorestore, luego migre sus aplicaciones al clúster Atlas Infinite.

Antes de ejecutar este procedimiento, tenga en cuenta los siguientes comportamientos:

  • Coherencia de los datos: Para evitar la pérdida de datos, detenga el guardado en su implementación de origen antes de ejecutar mongodump. Si ejecuta mongodump desde un nodo secundario, pause el guardar y luego espere a que el secundario se ponga al día con el primario antes de iniciar el vaciado.

  • Usuarios y roles: Atlas gestiona los usuarios de base de datos, por lo que mongorestore no puede migrar los usuarios o roles de base de datos existentes al clúster de destino. Cree los usuarios de base de datos que sus aplicaciones necesitan en el clúster Atlas Infinite de destino. Para aprender más, consulta Configurar usuarios de base de datos.

  • namespaces excluidos: Los directorios admin y config en el vaciado contienen información de usuario que mongorestore no puede añadir a un clúster Atlas Infinite, por lo que el procedimiento excluye admin.* y config.*.

  • Recursos del host: mongodump se ejecuta en un host con acceso a la red a su implementación de origen, y mongorestore se ejecuta en un host con acceso al fichero de archivo y acceso a la red a su implementación de destino. Ambas herramientas utilizan CPU y memoria en el host, lo que puede afectar el rendimiento de ese host.

1

Si la implementación de origen aplica la autenticación, mongodump debe autenticarse como un usuario de base de datos que pueda leer todas las bases de datos que migre. El rol de backup en la base de datos admin otorga estos privilegios.

Si no existe un usuario de este tipo en su implementación de origen, cree uno. Para aprender a crear y gestionar usuarios de base de datos, consulte la siguiente página para su tipo de implementación:

2

mongorestore debe autenticarse como un usuario de base de datos que pueda guardar en cada base de datos que migre. El Atlas admin rol en el clúster Atlas Infinite de destino otorga estos privilegios.

Si no existe dicho usuario en su clúster Atlas Infinite de destino, créelo. Para aprender a crear y gestionar usuarios de bases de datos en Atlas, consulta Configurar usuarios de bases de datos.

3

Asegúrese de que el host donde ejecute mongodump y mongorestore pueda acceder a ambas implementaciones:

  • Agregue el host a la lista de acceso IP para el Proyecto que contiene su clúster Atlas Infinite de destino. Para aprender cómo añadir un host a una lista de acceso IP, consulta Configurar entradas de la lista de acceso IP.

  • Si su implementación de origen es un clúster de Atlas Core en un Proyecto diferente, añada el host a la lista de acceso IP de ese Proyecto también. Si su implementación de origen es autogestionada, configure su firewall para aceptar conexiones del host. Para aprender más, consulte Reforzamiento de red y configuración.

Si configura el VPC emparejamiento, puede agregar el bloque CIDR de la VPC del par o una subred, o el grupo de seguridad de la VPC del par a la lista de acceso IP. Para obtener más información, consultar lista de acceso IP.

4
  1. Ensamble el comando mongodump.

    La siguiente plantilla de comando mongodump se conecta a un set de réplicas de origen o a un clúster autónomo mediante su cadena de conexión y genera un fichero del vaciado en un archivo.

    Copie la plantilla en su editor de texto preferido y reemplace el marcador de posición <connectionString> por la cadena de conexión de su implementación de origen, y <fileName> por el nombre del fichero de archivo que desea crear.

    mongodump --uri "<connectionString>" --archive=<fileName>.archive

    Para aprender a construir una cadena de conexión para su implementación de origen, consulte Cadenas de conexión.

    Nota

    Si se usa mongodump o mongorestore en Ubuntu 18.04, puede que experimentes un mensaje de error cannot unmarshal DNS al usar cadenas de conexión SRV (en la forma mongodb+srv://) con la opción --uri. En ese caso, utiliza una de las siguientes opciones en su lugar:

  2. Ejecute el comando completado desde un terminal o símbolo del sistema en un host que tenga acceso a la red a su implementación de origen.

    Ejemplo

    El siguiente comando mongodump se conecta a un clúster Atlas Core de origen mediante una cadena de conexión SRV, que contiene el nombre de usuario (mySourceUsername) y la contraseña (mySourcePassword) para un usuario de base de datos con el rol backup en la base de datos admin. El comando genera un fichero del vaciado en el archivo con el nombre mongodump.archive en el directorio de trabajo actual.

    mongodump --uri "mongodb+srv://mySourceUsername:mySourcePassword@cluster0.example.mongodb.net" \ --archive="mongodump.archive"
5
  1. Ensamble el comando mongorestore.

    La plantilla de comandos mongorestore siguiente se conecta a su clúster Atlas Infinite de destino mediante su cadena de conexión y realiza la restauración del fichero creado por mongodump. Utiliza --nsExclude para excluir las bases de datos admin y config que Atlas gestiona.

    Copia la plantilla en tu editor de texto preferido y reemplaza los siguientes marcadores de posición con los valores adecuados:

    • <connectionString>: sustituya esto por la cadena de conexión SRV para su clúster Atlas Infinite de destino. Para recuperar o construir una cadena de conexión para su clúster de destino, consulte Cadenas de conexión.

      Incluya el nombre de usuario y la contraseña de un usuario de base de datos con el rol Atlas admin en la cadena de conexión.

    • <filePath>: reemplaza esto con la ruta al fichero archivo creado por mongodump.

    Nota

    Si el nombre de usuario o la contraseña incluye los siguientes caracteres, deben convertirse mediante la codificación porcentual:

    $ : / ? # [ ] @
    mongorestore --uri "<connectionString>" \ --archive="<filePath>" \ --nsExclude "admin.*" \ --nsExclude "config.*"
  2. Ejecute el comando completado desde un terminal o una línea de comandos en un host que tenga acceso al fichero archivo creado por mongodump.

    Ejemplo

    El siguiente comando mongorestore se conecta a un clúster Atlas Infinite mediante una cadena de conexión SRV, que contiene el nombre de usuario (myDestinationUsername) y la contraseña (myDestinationPassword) para un usuario de base de datos con el rol Atlas admin. El comando realiza la restauración del fichero en mongodump.archive creado por mongodump, excluyendo las bases de datos admin y config.

    mongorestore --uri "mongodb+srv://myDestinationUsername:myDestinationPassword@cluster0.example.mongodb.net" \ --archive="mongodump.archive" \ --nsExclude "admin.*" \ --nsExclude "config.*"
6

Una vez completada la migración, conéctese a su clúster Atlas Infinite y compruebe que los datos se han migrado correctamente. Puede ejecutar query para comprobar la presencia de sus colecciones y documentos en el clúster de destino.

7

Después de verificar la migración, actualice sus aplicaciones para conectarse al clúster Atlas Infinite en lugar de la implementación de origen. Asegúrese de utilizar la cadena de conexión correcta y las credenciales para el clúster Atlas Infinite.

mongoimport lee un archivo JSON o CSV e inserta cada registro en una colección en un clúster de Atlas Infinite. El archivo puede provenir de una herramienta de exportación de terceros. Para la restauración de datos de una implementación de MongoDB en un clúster Atlas Infinite, consulte Restauración de datos de una implementación de MongoDB.

Antes de ejecutar este procedimiento, tenga en cuenta los siguientes comportamientos:

  • JSON extendido: mongoimport utiliza representación de modo estricto para determinados BSON types.

  • Solo documentos: A diferencia de mongorestore, mongoimport carga solo documentos, no opciones de colección ni definiciones de índice. Cree índices en el clúster de destino Atlas Infinite después de que finalice la importación.

  • Recursos del host: mongoimport se ejecuta en el host que contiene su archivo y utiliza la CPU y la memoria en ese host.

  • Otras interfaces: Para cargar un archivo sin la línea de comandos, utilice MongoDB Compass, que importa archivos JSON y CSV, o la Interfaz de Usuario de Atlas, que inserta documentos JSON que pegue o escriba.

1
  1. Si aún no aparece, se debe seleccionar la organización que contiene el proyecto en el menú Organizations de la barra de navegación.

  2. Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Database & Network Access en la sección Security.

La página Acceso a la base de datos y a la red se muestra después de completar los pasos anteriores.

2

Para ejecutar mongoimport para guardar en un clúster de Atlas, debe especificar un usuario de base de datos que tenga privilegios de readWrite en la base de datos en la que importar datos. Por ejemplo, un usuario con el rol de Atlas admin proporciona estos privilegios.

Si no existe tal usuario, cree uno:

  1. Si aún no se muestra, haz clic en la pestaña Database Users.

  2. Haga clic en Add New Database User.

  3. Agrega un usuario Atlas admin.

3
  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Clusters en la sección Database.

La página de clústeres se muestra.

4

Haz clic en Connect para el clúster de Atlas al que deseas migrar los datos.

5

Si el host donde vas a ejecutar mongoimport no está en la Lista de acceso IP, actualiza la lista. Puedes especificar uno de los dos:

  • La dirección IP pública del servidor en el que mongoimport se ejecutará, o

  • Si se configura para el emparejamiento VPC, se necesita el bloque CIDR (o una subred) de VPC del par o el Security Group de VPC del par, si has seleccionado AWS como el proveedor de nube.

6

Puedes conectarte a tu clúster de Atlas utilizando su URI de cadena de conexión. En el cuadro de diálogo de conexión, realiza los siguientes pasos:

  1. Haga clic en Drivers.

  2. Copie la cadena de conexión encontrada en el paso 1.

  3. Reemplace PASSWORD por la contraseña del usuario root y DATABASE por el nombre de la base de datos a la que desea conectarse.

    Importante

    Se debe escapar de cualquier instancia del carácter @ en el <PASSWORD> proporcionado. Por ejemplo, p@ssword debería ser p%40ssword.

Esta cadena de conexión se especifica en mongoimport en la opción --uri.

Cuando se utiliza --host, si el clúster de Atlas es un set de réplicas, también se debe recuperar el nombre del set de réplicas. Por ejemplo:

myAtlasRS/atlas-host1:27017,atlas-host2:27017,atlas-host3:27017
7

Las operaciones de guardar masivas envían muchos guardados a un clúster Atlas Infinite en una sola solicitud, lo que reduce los viajes de ida y vuelta de la red y aumenta el rendimiento de guardar. Elija este método para guardar documentos que genere en un clúster Atlas Infinite, en lugar de copiar datos de una implementación o archivo existente.

Antes de ejecutar este procedimiento, tenga en cuenta los siguientes comportamientos:

  • Comportamiento de escritura masiva: Las operaciones de escritura y las opciones que especifique en una solicitud de escritura masiva determinan cómo MongoDB ordena las operaciones de escritura, gestiona los errores y notifica los resultados para una solicitud. Para aprender cómo estas opciones afectan al comportamiento de la escritura masiva, consulte la página de referencia bulkWrite().

  • Otras interfaces: Para guardar un pequeño número de documentos sin lógica de agrupación, utilice insertMany() o insertOne() de mongosh o un driver de MongoDB, o la Interfaz de Usuario de Atlas, que inserta JSON documentos que pegue o escriba.

1

Para ejecutar las operaciones de guardado masiva en este procedimiento, conéctese a su clúster con mongosh. Para aprender cómo, consulta Conectarse a un clúster de Atlas.

También puede ejecutar operaciones de escritura masiva desde el código de la aplicación con un driver de MongoDB, desde la interfaz de usuario de Atlas o desde cualquier otra interfaz que se conecte a su clúster. Para aprender sobre las operaciones equivalentes en cada interfaz, consulte Operaciones de guardar masiva.

2

Para guardar en una sola colección, ejecute bulkWrite(). Para aprender más sobre los tipos de operaciones de guardar y las opciones de guardar masivas, consulte bulkWrite().

Por ejemplo, el siguiente comando inserta dos documentos en la colección inventory:

db.inventory.bulkWrite( [ { insertOne: { document: { _id: ObjectId("68b1c2d3e4f5a6b7c8d9e0f1"), item: "notebook", qty: 50 } } }, { insertOne: { document: { _id: ObjectId("68b1c2d3e4f5a6b7c8d9e0f2"), item: "pencil", qty: 100 } } }] )

Para guardar en varias colecciones o bases de datos en una solicitud, ejecute bulkWrite() y especifique el namespace para cada operación. Por ejemplo, el siguiente comando inserta un documento en la colección sales.inventory y un documento en la colección supplies.inventory:

db.getMongo().bulkWrite( [ { namespace: "sales.inventory", name: "insertOne", document: { item: "notebook", qty: 50 } }, { namespace: "supplies.inventory", name: "insertOne", document: { item: "pencil", qty: 100 } }] )

Por defecto, las operaciones de guardar masivas se ejecutan en orden y se detienen en el primer error. Para aprender a configurar el orden de ejecución, consulte Ejecución de operaciones.

3

Revise los recuentos que devuelve la operación y confirme el recuento de documentos en cada colección de destino. Para aprender más, consulta Salida.

Para aprender a gestionar errores para operaciones de guardar masiva, consulte Gestión de errores.

Atlas Infinite tiene una lista completa de limitaciones de la vista previa pública en Disponibilidad de la vista previa pública. Se aplican las siguientes limitaciones al cargar datos en un clúster Atlas Infinite:

  • Sin reproducción de oplog: Atlas Infinite no admite la reproducción de oplog. No utilice la mongodump --oplog opción o la mongorestore --oplogReplay opción con clústeres Atlas Infinite.

  • Queryable Encryption y cifrado a nivel de campo del lado del cliente: No puede utilizar mongodump o mongorestore con una colección que utiliza Queryable Encryption o cifrado a nivel de campo del lado del cliente.

  • Migración y restauración en vivo entre ediciones: Atlas Infinite no admite la migración en vivo ni la copia de seguridad y restauración entre clústeres de Atlas Core y Atlas Infinite. Las diferencias arquitectónicas entre las dos opciones de implementación hacen que los snapshot y las Migraciones en vivo sean incompatibles.