Module 1Exploiter les fonctionnalités des bases de données NoSQL MongoDB
Chapitre 6 sur 7
L'export et l'import avec mongoexport et mongoimport, la création des utilisateurs, les rôles et l'authentification.
Objectifs
Avec ce chapitre, tu sauras…
mongoexport ;mongoimport ;Leçon 1
Vue générale
MongoDB propose deux manières d'importer et d'exporter une base de données :
| Outils | Format | Usage |
|---|---|---|
mongoexport / mongoimport | fichiers lisibles : JSON, CSV | échanger des données avec d'autres programmes (Excel, une autre application…) |
mongodump / mongorestore | fichiers BSON (binaires) | sauvegarder et restaurer une base entière, avec tous les types et les index |
Le résumé s'intéresse à mongoexport / mongoimport :
mongoexport exporte les données d'une collection vers un fichier (JSON, CSV…) ;mongoimport importe dans une collection les données d'un fichier (JSON, CSV…).Deux points importants :
mongoexport et mongoimport sont des programmes à part entière (des exécutables), pas des commandes du shell MongoDB : on les tape dans l'invite de commandes (ou le terminal), pas dans mongosh ;mongod) doit être lancé : l'exécutable s'y connecte.Vidéo · À regarder
FRBase de données : MongoDB - Installation
Algomius · YouTube
| Option | Forme longue | Rôle |
|---|---|---|
-d | --db | la base de données |
-c | --collection | la collection |
-o | --out | le fichier de sortie (output) |
-f | --fields | les champs à exporter, séparés par des virgules |
Vidéo · À regarder
FRBase de données : MongoDB - Installation
Algomius · YouTube
Leçon 2
| Rôle | Explication |
|---|---|
read | lire les données de toutes les collections (non système) de la base |
readWrite | les droits de read, plus le droit d'écrire (insérer, modifier, supprimer) |
dbAdmin | administrer la base : index, statistiques, création et suppression de collections… (mais pas lire les données ni gérer les utilisateurs) |
userAdmin |
1mongoexport se tape…
2L'option documentée pour exporter en CSV est…
3En CSV, l'option -f sert à…
4Pour un CSV dont la première ligne contient les noms des colonnes, on ajoute…
5Le programme qui restaure une sauvegarde de mongodump est…
6Le rôle qui permet de lire ET d'écrire les données d'une base est…
7dbOwner combine…
8Après db.dropUser("UserAdmin"), db.getUser("UserAdmin") renvoie…
9Sans authorization: enabled, les utilisateurs créés…
L'essentiel du chapitre
mongoexport / mongoimport (fichiers JSON ou CSV) et mongodump / mongorestore (sauvegarde BSON) sont des exécutables (MongoDB Database Tools), lancés dans l'invite de commandes, serveur démarré.mongoexport -d base -c collection -o fichier.json ; CSV : --type=csv -f champ1,champ2 -o fichier.csv.mongoimport -d base -c collection --file fichier.json ; CSV : --type csv --file fichier.csv --headerline ; --drop pour vider avant.db.createUser({user, pwd, roles: [{role, db}]}), db.getUser(nom), db.dropUser(nom), db.auth(login, mdp) ; rôles read, readWrite, dbAdmin, userAdmin, dbOwner.security.authorization: enabled dans mongod.cfg, l'authentification n'est pas obligatoire : on crée d'abord un admin dans la base admin, puis on l'active.dbOwner | propriétaire de la base : combine readWrite, dbAdmin et userAdmin |
Vidéo · À regarder
FRBase de données : MongoDB - Gestion des utilisateurs
Algomius · YouTube
Vidéo · À regarder
FRBase de données : MongoDB - Gestion des utilisateurs
Algomius · YouTube
Vidéo · À regarder
FRBase de données : MongoDB - Gestion des utilisateurs
Algomius · YouTube
Depuis MongoDB 4.4, ces outils ne sont plus livrés avec le serveur : ils forment les MongoDB Database Tools, à télécharger à part sur mongodb.com (fichier .msi sous Windows). Après l'installation, ajoute leur dossier (par exemple C:\Program Files\MongoDB\Tools\100\bin) à la variable PATH, sinon l'invite de commandes répond « 'mongoexport' n'est pas reconnu… ».
Ce que tu vas voir (2 min) : le chapitre « MongoDB Database Tools ». Le formateur présente les MongoDB Database Tools (mongoexport, mongoimport, mongodump…) : ils s'installent à part du serveur.
Exporter les données : mongoexport
On peut exporter les données d'une collection vers un fichier JSON ou CSV. La syntaxe est simple.
mongoexport -d nomBaseDonnees -c nomDeLaCollection -o fichier.jsonCette commande exporte la collection nomDeLaCollection de la base nomBaseDonnees dans le fichier fichier.json. Si le fichier existe déjà, il est écrasé. (Le résumé l'écrit sur trois lignes ; dans l'invite de commandes, tape-la sur une seule ligne.)
mongoexport -d Examples -c Stagiaires -o C:/data/stagiaires.jsonconnected to: mongodb://localhost/
exported 4 recordsLe fichier contient un document JSON par ligne :
{"_id":{"$oid":"62e0f02cd55ee92da665d213"},"nom":"Alami","prenom":"Amina","filiere":{"_id":"DD","intitule":"Developpement digital"},"moy1A":14.5,"niveau":"2A","option":"Mobile"}{"$oid": …} est la façon d'écrire un ObjectId en JSON (format Extended JSON) : JSON ne connaît pas ce type. Pour obtenir un tableau JSON à la place, ajoute --jsonArray ; pour un fichier indenté, --pretty.
mongoexport -d nomBaseDonnees -c nomDeLaCollection -f champ_1,champ_2,champ_3 --csv -o fichier.csvCette commande exporte la collection dans le fichier fichier.csv. Si le fichier existe déjà, il est écrasé. En CSV, la liste des champs -f est obligatoire : un tableau a des colonnes fixes, alors que les documents peuvent avoir des champs différents.
mongoexport -d Examples -c Stagiaires -f _id,nom,prenom,moy1A,niveau,option --csv -o C:/data/Stagiaires.csvL'option --csv est une ancienne option : elle marche encore (testé avec les Database Tools 100.10), mais elle n'est plus documentée et peut disparaître. Écris --type=csv :
mongoexport -d Examples -c Stagiaires -f _id,nom,prenom,moy1A,niveau,option --type=csv -o C:/data/Stagiaires.csv
Dans l'exemple du résumé, l'option est aussi coupée en deux lignes (-- puis csv) : une commande s'écrit sur une seule ligne.
_id,nom,prenom,moy1A,niveau,option
ObjectId(62e0f02cd55ee92da665d213),Alami,Amina,14.5,2A,Mobile
ObjectId(62e0f02cd55ee92da665d214),Ennaim,Nidal,17.25,2A,Cyber Security
ObjectId(62e0f02cd55ee92da665d215),Alami,Salim,12.75,2A,FullStack
ObjectId(62e0f02cd55ee92da665d216),Dalil,Karima,,1A,La première ligne contient les noms des colonnes. Karima n'a ni moyenne ni option : ses cases sont vides. Pour un sous-champ, on écrit filiere.intitule dans la liste -f.
On peut aussi n'exporter qu'une partie des documents avec -q (query) : mongoexport -d Examples -c Stagiaires -q "{\"niveau\":\"2A\"}" -o deuxieme_annee.json.
Importer les données : mongoimport
On peut importer des données à partir d'un fichier JSON ou CSV.
mongoimport -d nomBaseDonnees -c nomDeLaCollection fichier.jsonCette commande importe dans la collection nomDeLaCollection de la base nomBaseDonnees les données du fichier fichier.json. Si le fichier n'existe pas, une erreur est déclenchée. Si la collection n'existe pas, elle est créée.
mongoimport -d Examples -c Stagiaires -o C:/data/stagiaires.jsonCet exemple utilise -o (fichier de sortie), qui n'existe pas pour mongoimport : error parsing command line options: unknown option "o". On donne le fichier avec --file (ou simplement à la fin, comme dans la syntaxe) :
mongoimport -d Examples -c Stagiaires --file C:/data/stagiaires.json
Et si les documents existent déjà (même _id), l'import affiche des erreurs E11000 duplicate key error pour chacun d'eux et ne les importe pas. Pour vider la collection avant d'importer, ajoute --drop. Pour un fichier qui contient un tableau JSON, ajoute --jsonArray.
connected to: mongodb://localhost/
4 document(s) imported successfully. 0 document(s) failed to import.Si les 4 stagiaires sont déjà dans la collection, le résultat est : continuing through error: E11000 duplicate key error collection: Examples.Stagiaires puis 0 document(s) imported successfully. 4 document(s) failed to import.
mongoimport -d nomBaseDonnees -c nomDeLaCollection --type csv --file fichier.csv --headerlineCette commande importe dans la collection nomDeLaCollection les lignes du fichier fichier.csv. --headerline indique que la première ligne du fichier contient les noms des champs. Si le fichier n'existe pas, une erreur est déclenchée.
mongoimport -d database_name -c collection_name --type csv --file locations.csv --headerlinemongoimport -d Examples -c Stagiaires --type csv --file C:/data/Stagiaires.csv --headerline--type csv, (avec une virgule) et l'exemple -type csv –file (un seul tiret, puis un tiret long copié depuis Word) : les options longues s'écrivent avec deux tirets droits : --type csv --file.--headerline (ou --fields), mongoimport refuse un CSV (must specify --fields, --fieldFile or --headerline to import this file type) : il ne sait pas comment nommer les champs.ObjectId(62e0…) dans la colonne _id : réimporté tel quel, il devient une chaîne de caractères. Pour garder les vrais types, on exporte en JSON, ou on utilise mongodump / mongorestore.mongodump -d Examples -o C:/sauvegardes
mongorestore -d Examples C:/sauvegardes/ExamplesCe que tu vas voir (10 min) : le chapitre « Importer des valeurs dans une collection ». Il importe un fichier de données dans une collection avec mongoimport, depuis l'invite de commandes.
Créer un utilisateur
user) ;pwd) ;roles).use Examples
db.createUser(
{user: "UserAdmin",
pwd: "password" ,
"roles" : [
{
"role" : "userAdmin",
"db" : "Examples"
}
]
}
)L'utilisateur est créé dans la base courante (Examples) : c'est sa base d'authentification. Le shell répond { ok: 1 }.
Dans mongosh, on peut remplacer le mot de passe écrit en clair par passwordPrompt() : pwd: passwordPrompt(). Le shell demande alors le mot de passe sans l'afficher ni le garder dans l'historique. Et choisis un vrai mot de passe : « password » est le premier essayé par un pirate.
Tableau: Les rôles d'un utilisateur
Pour la base eshop_db :
mongodump, puis exporte le catalogue (produits : désignation, prix, stock) en CSV pour le service commercial.site_web (lire et écrire, pour l'application), commercial (lecture seule) et gerant (propriétaire de la base).caisse.py (chapitre 5) doit utiliser avec l'utilisateur site_web.produits, puis restaure-la avec mongorestore.Dans l'invite de commandes :
Stagiaires de la base Examples en JSON dans stagiaires.json.stagiaires.csv.stagiaires.json dans une nouvelle collection Stagiaires_copie.stagiaires.csv dans la collection Stagiaires_csv. Que devient l'intitulé de la filière ?L'utilisateur UserAdmin du résumé a seulement le rôle userAdmin : il peut créer des utilisateurs… mais pas lire les stagiaires ! db.Stagiaires.find() lui renvoie l'erreur not authorized on Examples to execute command { find: "Stagiaires" … }. Pour une application, on crée un autre utilisateur avec readWrite. Donner à chacun juste les droits dont il a besoin, c'est le principe du moindre privilège (comme GRANT en MySQL, partie 1).
use Examples
db.createUser({ user: "appStagiaires", pwd: "Ofppt#2026!", roles: [ { role: "readWrite", db: "Examples" } ] })
db.createUser({ user: "lecteur", pwd: "Lire#2026!", roles: [ "read" ] })Quand le rôle porte sur la base courante, on peut écrire seulement son nom ("read") au lieu de { role: "read", db: "Examples" }. On ajoute ou retire un rôle plus tard avec db.grantRolesToUser("lecteur", ["readWrite"]) et db.revokeRolesFromUser("lecteur", ["readWrite"]).
Ce que tu vas voir (21 min) : le chapitre « Création des utilisateurs ». Le formateur crée des utilisateurs avec db.createUser et leur donne des rôles, puis teste ce qu'ils ont le droit de faire.
Afficher les détails d'un utilisateur
db.getUser(user){
"_id" : "Examples.UserAdmin",
"userId" : UUID("8d6ea3c4-d054-447e-bde7-cd5dc9de5140"),
"user" : "UserAdmin",
"db" : "Examples",
"roles" : [
{ "role" : "userAdmin", "db" : "Examples" }
],
"mechanisms" : [ "SCRAM-SHA-1", "SCRAM-SHA-256" ]
}_id : base.utilisateur, l'espace de noms de l'utilisateur (chapitre 3) ;mechanisms : les méthodes d'authentification. SCRAM vérifie le mot de passe sans jamais l'envoyer en clair ; le serveur n'en garde qu'une empreinte (un hash).db.getUsers() liste tous les utilisateurs de la base courante.
Supprimer un utilisateur
db.dropUser(user)use Examples
db.dropUser("UserAdmin")
db.getUser("UserAdmin")switched to db Examples
true
nulldropUser répond true (dans mongosh : { ok: 1 }), puis getUser répond null : l'utilisateur n'existe plus.
Le résultat affiché se termine par « nul » : c'est null.
L'authentification à la base de données
Pour s'authentifier sur la base avec le compte d'un utilisateur :
db.auth(<login>,<motDePasse>)use Examples
db.auth("UserAdmin","password")switched to db Examples
11 veut dire que l'authentification a réussi (dans mongosh, la réponse est { ok: 1 }). Avec un mauvais mot de passe : MongoServerError: Authentication failed.
On peut ensuite tester les droits déjà attribués à l'utilisateur : essayer une lecture, une écriture, une création d'utilisateur, et voir lesquelles sont refusées (exercice 6.3).
On peut aussi se connecter directement avec un utilisateur, depuis l'invite de commandes :
mongosh "mongodb://appStagiaires:Ofppt%232026!@localhost:27017/Examples"Dans une URI, les caractères spéciaux du mot de passe s'écrivent en pourcentage (# devient %23). En Python : MongoClient("mongodb://appStagiaires:Ofppt%232026!@localhost:27017/Examples").
Par défaut, MongoDB n'oblige personne à s'authentifier : n'importe qui peut se connecter sans mot de passe et tout lire, même après createUser. Pour que les utilisateurs et les rôles servent à quelque chose, il faut activer l'authentification :
admin, avec le rôle userAdminAnyDatabase (sinon, plus personne ne pourra créer d'utilisateurs) :use admin
db.createUser({ user: "admin", pwd: passwordPrompt(), roles: [ { role: "userAdminAnyDatabase", db: "admin" }, "readWriteAnyDatabase" ] })
mongod.cfg (sous Windows : C:\Program Files\MongoDB\Server\8.0\bin\mongod.cfg) :security:
authorization: enabled
net stop MongoDB puis net start MongoDB en administrateur) ;mongosh -u admin -p --authenticationDatabase admin.Ce que tu vas voir (20 min) : les chapitres « Création de l'administrateur des utilisateurs », « Mise en place de l'authentification », « Première connexion avec l'admin ». Il crée l'administrateur des utilisateurs, active l'authentification dans la configuration du serveur, puis se connecte une première fois avec cet administrateur : c'est le point oublié par le résumé.
Ce que tu vas voir (16 min) : le chapitre « Création de rôle ». Pour aller plus loin, il crée son propre rôle avec des privilèges choisis.
Sur la base Examples :
formateur (mot de passe de ton choix) qui peut seulement lire les données.secretariat qui peut lire et écrire.formateur.formateur avec db.auth. Essaie un find puis un insertOne. Que se passe-t-il (le contrôle d'accès étant activé) ?readWrite au formateur, puis supprime l'utilisateur secretariat.