MongoDB Insertar documentos
En este capítulo presentaremos cómo insertar datos en una colección de MongoDB.
La estructura de datos de los documentos es básicamente la misma que JSON.
Todos los datos almacenados en la colección están en formato BSON.
BSON es un formato de almacenamiento binario similar a JSON, abreviatura de Binary JSON.
Los métodos comunes para insertar documentos incluyen:
| Método | Uso | ¿Obsoleto? |
|---|---|---|
insertOne() | Insertar un solo documento | no |
insertMany() | Insertar varios documentos | no |
insert() | Insertar uno o varios documentos | Sí |
save() | Insertar o actualizar documento | Sí |
1、insertOne()
El método insertOne() se utiliza para insertar un solo documento en la colección.
db.collection.insertOne(document, options)
- document: el documento único a insertar.
- options (opcional): un objeto de parámetros opcional que puede incluir writeConcern y bypassDocumentValidation, etc.
Ejemplo
name: "Alice",
age: 25,
city: "New York"
});
Resultado devuelto:
{
"acknowledged": true,
"insertedId": ObjectId("60c72b2f9b1d8b5a5f8e2b2d")
}
2、insertMany()
El método insertMany() se utiliza para insertar varios documentos en la colección.
db.collection.insertMany(documents, options)
- documents: la matriz de documentos a insertar.
- options (opcional): un objeto de parámetros opcional que puede incluir ordered, writeConcern y bypassDocumentValidation, etc.
db.myCollection.insertMany([
{ name: "Bob", age: 30, city: "Los Angeles" },
{ name: "Charlie", age: 35, city: "Chicago" }
]);Resultado devuelto:
{
"acknowledged": true,
"insertedIds": [
ObjectId("60c72b2f9b1d8b5a5f8e2b2e"),
ObjectId("60c72b2f9b1d8b5a5f8e2b2f")
]
}
3、db.collection.save()
El método save() se comporta de manera similar a insertOne() al insertar documentos.
Si el documento contiene el campo _id y ya existe, el documento se actualizará; si el documento no contiene el campo _id o el _id no existe, se insertará un nuevo documento.
A partir de MongoDB 4.2, db.collection.save() ha sido marcado como obsoleto (deprecated); oficialmente se recomienda usar db.collection.insertOne() o db.collection.replaceOne() como reemplazo.
db.collection.save(document, options)
- document: el documento a guardar.
- options (opcional): un objeto de parámetros opcional que puede incluir writeConcern, etc.
db.myCollection.save({
_id: ObjectId("60c72b2f9b1d8b5a5f8e2b2d"),
name: "David",
age: 40,
city: "San Francisco"
});
Insertar documentos individuales o múltiples (método antiguo)
Use el método db.collection.insert() para insertar uno o varios documentos.
El método insert() ha sido marcado como obsoleto (deprecated) en MongoDB 4.2 y versiones posteriores; se recomienda usar insertOne() e insertMany().
Sintaxis:
db.collection.insert(document_or_array)
Parámetros:
Puede ser un documento o una matriz de documentos.
1. Insertar un solo documento:
db.users.insert({ name: "David", age: 40, email: "david@example.com" });
2. Insertar varios documentos:
db.users.insert([
{ name: "Eve", age: 45, email: "eve@example.com" },
{ name: "Frank", age: 50, email: "frank@example.com" }
]);
Optimización del rendimiento para inserción por lotes
Si necesita insertar una gran cantidad de documentos, puede usar insertMany() y habilitarordered: falseopción, para mejorar el rendimiento de la inserción.
Sintaxis:
db.collection.insertMany([document1, document2, ...], { ordered: false })
Parámetros:
ordered: falseIndica inserción desordenada: incluso si falla la inserción de un documento, no afectará la inserción de otros documentos.
Ejemplo
{ name: "Henry", age: 60 },
{ name: "Ivy", age: 65 }
], { ordered: false });
Validación al insertar
MongoDB valida los documentos insertados de acuerdo con las reglas de validación de esquema de la colección (si están definidas). Si el documento no cumple las reglas, la operación de inserción fallará.
Supongamos que la colección users tiene una regla de validación que requiere que el campo age sea mayor que 0:
db.createCollection("users", {
validator: {
age: { $gt: 0 }
}
});Si se inserta el siguiente documento, fallará:
db.users.insertOne({ name: "John", age: -5 }); // 验证失败 Otras extensiones