MongoDB Insérer des documents
Dans ce chapitre, nous allons vous montrer comment insérer des données dans les collections MongoDB.
La structure des données des documents est essentiellement la même que celle de JSON.
Toutes les données stockées dans les collections sont au format BSON.
BSON est un format de stockage binaire similaire à JSON, et est l'abréviation de Binary JSON.
Les méthodes courantes d'insertion de documents incluent :
| Méthode | Objectif | Obsolète ? |
|---|---|---|
insertOne() | Insérer un seul document | non |
insertMany() | Insérer plusieurs documents | non |
insert() | Insérer un ou plusieurs documents | Oui |
save() | Insérer ou mettre à jour un document | Oui |
1、insertOne()
La méthode insertOne() est utilisée pour insérer un seul document dans une collection.
db.collection.insertOne(document, options)
- document : Le document unique à insérer.
- options (facultatif) : objet de paramètres facultatif pouvant inclure writeConcern, bypassDocumentValidation, etc.
Exemple
name: "Alice",
age: 25,
city: "New York"
});
Résultat renvoyé :
{
"acknowledged": true,
"insertedId": ObjectId("60c72b2f9b1d8b5a5f8e2b2d")
}
2、insertMany()
La méthode insertMany() est utilisée pour insérer plusieurs documents dans une collection.
db.collection.insertMany(documents, options)
- documents : un tableau de documents à insérer.
- options (facultatif) : objet de paramètres facultatif pouvant inclure ordered, writeConcern, bypassDocumentValidation, etc.
db.myCollection.insertMany([
{ name: "Bob", age: 30, city: "Los Angeles" },
{ name: "Charlie", age: 35, city: "Chicago" }
]);Résultat renvoyé :
{
"acknowledged": true,
"insertedIds": [
ObjectId("60c72b2f9b1d8b5a5f8e2b2e"),
ObjectId("60c72b2f9b1d8b5a5f8e2b2f")
]
}
3、db.collection.save()
La méthode save() se comporte de manière similaire à insertOne() lors de l'insertion de documents.
Si le document contient un champ _id et qu'il existe déjà, le document sera mis à jour ; s'il ne contient pas de champ _id ou si le _id n'existe pas, un nouveau document sera inséré.
Depuis MongoDB 4.2, db.collection.save() est marquée comme obsolète, et la recommandation officielle est d'utiliser plutôt db.collection.insertOne() ou db.collection.replaceOne().
db.collection.save(document, options)
- document : le document à enregistrer.
- options (facultatif) : Un objet paramètre facultatif pouvant inclure writeConcern, etc.
db.myCollection.save({
_id: ObjectId("60c72b2f9b1d8b5a5f8e2b2d"),
name: "David",
age: 40,
city: "San Francisco"
});
Insérer un ou plusieurs documents (ancienne méthode)
Utilisez la méthode db.collection.insert() pour insérer un ou plusieurs documents.
La méthode insert() a été marquée comme obsolète dans MongoDB 4.2 et versions ultérieures, et il est recommandé d'utiliser insertOne() et insertMany().
Syntaxe :
db.collection.insert(document_or_array)
Paramètres :
Il peut s'agir d'un document ou d'un tableau de documents.
1. Insérer un seul document :
db.users.insert({ name: "David", age: 40, email: "david@example.com" });
2. Insérer plusieurs documents :
db.users.insert([
{ name: "Eve", age: 45, email: "eve@example.com" },
{ name: "Frank", age: 50, email: "frank@example.com" }
]);
Optimisation des performances pour les insertions en masse
Si vous devez insérer un grand nombre de documents, vous pouvez utiliser insertMany() et activer l'optionordered: falsepour améliorer les performances d'insertion.
Syntaxe :
db.collection.insertMany([document1, document2, ...], { ordered: false })
Paramètres :
ordered: false: Indique une insertion non ordonnée. Même si l'insertion d'un document échoue, cela n'affecte pas l'insertion des autres documents.
Exemple
{ name: "Henry", age: 60 },
{ name: "Ivy", age: 65 }
], { ordered: false });
Validation lors de l'insertion
MongoDB valide les documents insérés selon les règles de validation de schéma de la collection (si elles sont définies). Si un document ne respecte pas les règles, l'opération d'insertion échouera.
Supposons que la collection users ait une règle de validation qui exige que le champ age soit supérieur à 0 :
db.createCollection("users", {
validator: {
age: { $gt: 0 }
}
});L'insertion du document suivant échouera :
db.users.insertOne({ name: "John", age: -5 }); // 验证失败 Autres extensions