Cómo importar y exportar una base de datos de MongoDB en Ubuntu 20.04

El autor seleccionó COVID-19 Relief Fund para que reciba una donación como parte del programa Write for DOnations.

Introducción

MongoDB es uno de los motores de base de datos más populares de NoSQL. Es famoso por ser escalable, potente, confiable y fácil de usar. En este artículo, le mostraremos cómo importar y exportar sus bases de datos de MongoDB.

Debemos aclarar que importar y exportar se refiere a aquellas operaciones que manejan los datos en un formato legible por el ser humano, compatible con otros productos de software. Por el contrario, las operaciones de copia de seguridad y restauración crean o utilizan datos binarios específicos de MongoDB, que preservan la uniformidad y la integridad de sus datos, y también sus atributos específicos de MongoDB. Por lo tanto, para migrar, generalmente es preferible usar la copia de seguridad y la restauración siempre que los sistemas de origen y destino sean compatibles.

Las tareas de copia de seguridad, restauración y migración están fuera del alcance de este artículo. Para obtener más información, consulte Cómo respaldar, restaurar y migrar una base de datos de MongoDB en Ubuntu 20.04.

Requisitos previos

Para completar este tutorial, necesitará lo siguiente:

• Un droplet de Ubuntu 20.04 configurado mediante la guía de configuración inicial para servidores de Ubuntu 20.04, incluyendo un usuario sudo no root y un firewall.
• MongoDB instalado y configurado usando el artículo Cómo instalar MongoDB en Ubuntu 20.04.
• Un entendimiento de las diferencias entre los datos JSON y BSON en MongoDB. Para obtener un análisis más detallado, consulte el Paso 1: Usar JSON y BSON en MongoDB en nuestro tutorial, Cómo hacer una copia de seguridad, restaurar y migrar una base de datos de MongoDB en Ubuntu 20.04.

Paso 1: Importar la información a MongoDB

Para aprender cómo funciona la importación de información a MongoDB vamos a utilizar una base de datos popular de MongoDB de muestra sobre restaurantes. Está en formato .json y se puede descargar con wget de esta manera:

wget https://raw.githubusercontent.com/mongodb/docs-assets/primer-dataset/primer-dataset.json

Una vez completada la descarga, debería tener un archivo llamado primer-dataset.json (12 MB de tamaño) en el directorio actual. Importaremos los datos de este archivo a una nueva base de datos llamada newdb y a una colección llamada restaurants.

Utilice el comando mongoimport de esta manera:

sudo mongoimport --db newdb --collection restaurants --file primer-dataset.json

El resultado tendrá el siguiente aspecto:

Output
2020-11-11T19:37:55.607+0000	connected to: mongodb://localhost/
2020-11-11T19:37:57.841+0000	25359 document(s) imported successfully. 0 document(s) failed to import

Como muestra el comando anterior, se han importado 25359 documentos. Dado que no teníamos una base de datos llamada newdb, MongoDB la creó de forma automática.

Vamos a verificar la importación.

Conéctese a la base de datos newdb recientemente creada:

sudo mongo newdb

Ahora está conectado a la instancia de la base de datos newdb. Observe que la línea de comandos ha cambiado, indicando que está conectado a la base de datos.

Cuente los documentos de la colección de restaurantes con el comando:

db.restaurants.count()

El resultado mostrará 25359, que es el número de documentos importados. Para obtener una comprobación aún mejor, puede seleccionar el primer documento de la colección de restaurantes de esta manera:

db.restaurants.findOne()

El resultado tendrá el siguiente aspecto:

[secondary label Output]
{
	"_id" : ObjectId("5fac3d937f12c471b3f26733"),
	"address" : {
		"building" : "1007",
		"coord" : [
			-73.856077,
			40.848447
		],
		"street" : "Morris Park Ave",
		"zipcode" : "10462"
	},
	"borough" : "Bronx",
	"cuisine" : "Bakery",
	"grades" : [
		{
			"date" : ISODate("2014-03-03T00:00:00Z"),
			"grade" : "A",
			"score" : 2
		},
...
	],
	"name" : "Morris Park Bake Shop",
	"restaurant_id" : "30075445"
}

Una comprobación tan detallada podría revelar problemas con los documentos, tales como el contenido, la codificación, etc. El formato json utiliza la codificación UTF-8 sus exportaciones e importaciones deberían estar en dicha codificación. Tenga esto en cuenta si edita los archivos json de forma manual. De lo contrario, MongoDB se encargará de ello automáticamente.

Para salir de la línea de comandos de MongoDB, escriba exit en la línea de comandos:

exit

Volverá a la línea de comandos normal como usuario no root.

Paso 2: Exportar información desde MongoDB

Como mencionamos antes, cuando exporta la información de MongoDB, puede obtener un archivo de texto legible por el ser humano con sus datos. De manera predeterminada, la información se exportará en formato json, pero también puede exportar a csv (valor separado por comas).

Para exportar información desde MongoDB, utilice el comando mongoexport. Le permite exportar de forma muy detallada, de modo que puede especificar una base de datos, una colección, un campo e incluso utilizar una consulta para la exportación.

Un ejemplo simple de mongoexport sería exportar la colección de restaurantes desde la base de datos newdb que hemos importado anteriormente. Puede hacerse de esta manera:

sudo mongoexport --db newdb -c restaurants --out newdbexport.json

En el comando anterior, se utilizó --db para especificar la base de datos, -c para la colección y --out, para el archivo en el que se guardarán los datos.

El resultado de una exitosa exportación de mongoexport debe tener el siguiente aspecto:

Output
2020-11-11T19:39:57.595+0000	connected to: mongodb://localhost/
2020-11-11T19:39:58.619+0000	[###############.........]  newdb.restaurants  16000/25359  (63.1%)
2020-11-11T19:39:58.871+0000	[########################]  newdb.restaurants  25359/25359  (100.0%)
2020-11-11T19:39:58.871+0000	exported 25359 records

El resultado anterior muestra que se han importado 25359 documentos, el mismo número que de los documentos importados.

En algunos casos, es posible que necesite exportar solo una parte de su colección. Teniendo en cuenta la estructura y el contenido del archivo json de los restaurantes, vamos a exportar todos los restaurantes que cumplen los criterios de estar situados en el barrio del Bronx y de tener cocina china. Si queremos obtener esta información directamente mientras estamos conectados a MongoDB, vuelva a conectarse a la base de datos:

sudo mongo newdb

Luego, utilice esta consulta:

db.restaurants.find( { "borough": "Bronx", "cuisine": "Chinese" } )

Los resultados se muestran en el terminal:

Output
2020-12-03T01:35:25.366+0000	connected to: mongodb://localhost/
2020-12-03T01:35:25.410+0000	exported 323 records

Para salir de la línea de comandos de MongoDB, escriba exit:

exit

Si desea exportar los datos de una línea de comandos sudo en lugar de mientras está conectado a la base de datos, haga que la consulta anterior forme parte del comando mongoexport especificándolo para el argumento -q de esta manera:

sudo mongoexport --db newdb -c restaurants -q "{\"borough\": \"Bronx\", \"cuisine\": \"Chinese\"}" --out Bronx_Chinese_retaurants.json

Tenga en cuenta que estamos evitando las comillas dobles con una barra oblicua inversa (\) en la consulta. De manera similar, tiene que evitar cualquier otro carácter especial en la consulta.

Si la exportación se realizó de forma correcta, el resultado debería tener el siguiente aspecto:

Output
2020-11-11T19:49:21.727+0000	connected to: mongodb://localhost/
2020-11-11T19:49:21.765+0000	exported 323 records

Lo anterior muestra que se han exportado 323 registros y puede encontrarlos en el archivo Bronx_Chinese_retaurants.json que especificamos.

Utilice cat y less para escanear los datos:

cat Bronx_Chinese_retaurants.json | less

Utilice SPACE para navegar por los datos:

Output
date":{"$date":"2015-01-14T00:00:00Z"},"grade":"Z","score":36}],"na{"_id":{"$oid":"5fc8402d141f5e54f9054f8d"},"address":{"building":"1236","coord":[-73.8893654,40.81376179999999],"street":"238 Spofford Ave","zipcode":"10474"},"borough":"Bronx","cuisine":"Chinese","grades":[{"date":{"$date":"2013-12-30T00:00:00Z"},"grade":"A","score":8},{"date":{"$date":"2013-01-08T00:00:00Z"},"grade":"A","score":10},{"date":{"$date":"2012-06-12T00:00:00Z"},"grade":"B","score":15}],

. . .

Presione q para salir. Ahora puede importar y exportar una base de datos de MongoDB.

Conclusión

Este artículo le ha presentado los aspectos esenciales de importación y exportación de información desde y hacia una base de datos de MongoDB. Puede continuar leyendo sobre Cómo hacer una copia de seguridad, restaurar y migrar una base de datos de MongoDB en Ubuntu 20.04.

También puede considerar usar la replicación. La replicación le permite continuar ejecutando su servicio de MongoDB sin interrupción desde un servidor de MongoDB esclavo mientras restaura el maestro tras un fallo. Parte de la replicación es el registro de operaciones (oplog), que registra todas las operaciones que modifican sus datos. Puede usar este registro, igual que usaría el registro binario en MySQL, para restaurar sus datos después de haber realizado la última copia de seguridad. Recuerde que las copias de seguridad suelen realizarse durante la noche, y si decide restaurar una copia de seguridad en la noche, se perderá todas las actualizaciones desde la última copia de seguridad.