Importer, exporter et restaurer des données

1. L’utilitaire mongoimport

Le programme mongoimport vous sera d’une grande utilité pour importer des données contenues dans des fichiers au format JSON, CSV ou TSV (dans les premiers, les champs sont séparés par des virgules tandis que dans le dernier ils sont séparés par des tabulations). Comme mongofiles, il ne s’utilise pas depuis le shell, mais depuis un terminal. Nous effectuerons les commandes à venir avec l’utilisateur mongosensei, créé il y a plusieurs chapitres de cela. Pour qu’un utilisateur puisse effectuer des opérations d’importation, il doit au moins posséder le rôle readWrite sur la base de données qu’il cible, ce qui est le cas de mongosensei.

Cet utilitaire ne prend en charge que les documents dont le codage est UTF-8 et toute tentative d’importer des données depuis un fichier comportant un autre codage se soldera par un échec. Voici par exemple l’erreur levée par une tentative d’importation depuis un fichier codé en UTF-16 :

connected to: localhost 
Failed: error processing document #1: invalid character 'ÿ' 
looking for beginning of value 
imported 0 documents 

Importer des données depuis un fichier JSON

JSON est le format utilisé par défaut par mongoimport. Pour réaliser notre premier import, nous écrivons un fichier spectacle.json qui contient trois documents, chacun occupant une ligne :

{"_id": 1, "titre": "Platonov", "auteur": "Tchekov", "lieu": "Théâtre 
Golovine",  
"date": ISODate("2019-07-25T22:00:00Z"), "prix": 20} 
{"_id": 2, "titre": "Hamlet", "auteur": "Shakespeare", "lieu": 
"Théâtre du  
Forum", "date": ISODate("2019-07-24T20:00:00Z"), "prix": 17} 
{"_id": 3, "titre": "L'Avare", "auteur": "Molière", "lieu": 
"Théâtre des Doms",  
"date": ISODate("2019-07-23T20:00:00Z"), "prix": 15} 

Nous utiliserons la commande d’importation avec les paramètres d’authentification...

1. L’utilitaire mongodump

L’exécutable mongodump permet de créer un export de vos bases de données au format binaire. Écrivons la commande qui permettra d’exporter le contenu de la base de données test, qui a servi à la majeure partie de nos exemples, dans le répertoire/tmp (attention, si des fichiers d’export s’y trouvent déjà, ils seront écrasés !) :

mongodump -u "mongosensei" --authenticationDatabase "admin" \ 
--db test -o=/tmp --password M0ng0d3! 

Voici une partie de l’affichage que nous obtenons :

writing test.personnel to 
writing test.athletes to 
done dumping test.athletes (9 documents) 
done dumping test.personnel (9 documents) 
writing test.personnes to 
writing test.cursus to 
writing test.livres to 
done dumping test.personnes (8 documents) 
writing test.trajets to 
done dumping test.cursus (7 documents) 
writing test.boutique to 
done dumping test.livres (7 documents) 
writing test.instaton to 
done dumping test.trajets (7 documents) 
writing test.bazar to 
done dumping test.instaton (5 documents) 
writing test.theatres to 
done dumping test.bazar (5 documents) 
writing test.avignon to 
done dumping test.boutique (6 documents) 
writing test.supermerkat to 
done dumping test.theatres (5 documents) 

Si nous prenons la peine de regarder ce qui se trouve dans le répertoire /tmp, nous constatons que mongodump a créé un sous-répertoire portant le nom de la base de données ciblée. Pour chaque collection, nous trouvons deux fichiers : l’un d’entre eux porte l’extension .json et l’autre .bson. Si nous consultons le contenu du fichier qui contient les métadonnées au format JSON, nous pouvons y voir les index que nous avons posés :

cat personnes.metadata.json 
{"options":{},"indexes":[{"v":2,"key": 
"_id":1},"name":"_id_","ns":"test.personnes"},{"v":2,"key": ...