MongoDB Вставка документов
В этой главе мы покажем вам, как вставлять данные в коллекции MongoDB.
Структура данных документов в основном совпадает с JSON.
Все данные, хранящиеся в коллекциях, представлены в формате BSON.
BSON — это двоичный формат хранения, похожий на JSON, сокращение от Binary JSON.
К распространённым методам вставки документов относятся:
| Метод | Назначение | Устаревший? |
|---|---|---|
insertOne() | Вставка одного документа | нет |
insertMany() | Вставка нескольких документов | нет |
insert() | Вставка одного или нескольких документов | Да |
save() | Вставка или обновление документа | Да |
1、insertOne()
Метод insertOne() используется для вставки одного документа в коллекцию.
db.collection.insertOne(document, options)
- document: вставляемый документ.
- options (необязательно): Необязательный объект параметров, который может включать writeConcern, bypassDocumentValidation и т. д.
Пример
name: "Alice",
age: 25,
city: "Нью-Йорк"
});
Возвращённый результат:
{
"acknowledged": true,
"insertedId": ObjectId("60c72b2f9b1d8b5a5f8e2b2d")
}
2. insertMany()
Метод insertMany() используется для вставки нескольких документов в коллекцию.
db.collection.insertMany(documents, options)
- documents: Массив документов для вставки.
- options (необязательно): Необязательный объект параметров, который может включать ordered, writeConcern, bypassDocumentValidation и т. д.
db.myCollection.insertMany([
{ name: "Bob", age: 30, city: "Los Angeles" },
{ name: "Charlie", age: 35, city: "Chicago" }
]);Возвращённый результат:
{
"acknowledged": true,
"insertedIds": [
ObjectId("60c72b2f9b1d8b5a5f8e2b2e"),
ObjectId("60c72b2f9b1d8b5a5f8e2b2f")
]
}
3. db.collection.save()
Метод save() ведёт себя аналогично insertOne() при вставке документов.
Если документ содержит поле _id и оно уже существует, документ будет обновлён; если документ не содержит поля _id или _id не существует, будет вставлен новый документ.
Начиная с MongoDB 4.2, db.collection.save() помечен как устаревший, и официально рекомендуется использовать вместо него db.collection.insertOne() или db.collection.replaceOne().
db.collection.save(document, options)
- document: Документ для сохранения.
- options (необязательно): Необязательный объект параметров, который может включать writeConcern и т. д.
db.myCollection.save({
_id: ObjectId("60c72b2f9b1d8b5a5f8e2b2d"),
name: "David",
age: 40,
city: "San Francisco"
});
Вставка одного или нескольких документов (старый метод)
Используйте метод db.collection.insert() для вставки одного или нескольких документов.
Метод insert() помечен как устаревший в MongoDB 4.2 и более поздних версиях, и рекомендуется использовать insertOne() и insertMany().
Синтаксис:
db.collection.insert(document_or_array)
Параметры:
Это может быть документ или массив документов.
1. Вставка одного документа:
db.users.insert({ name: "David", age: 40, email: "david@example.com" });
2. Вставка нескольких документов:
db.users.insert([
{ name: "Eve", age: 45, email: "eve@example.com" },
{ name: "Frank", age: 50, email: "frank@example.com" }
]);
Оптимизация производительности для массовых вставок
Если вам нужно вставить большое количество документов, вы можете использовать insertMany() и включить опциюordered: false, чтобы повысить производительность вставки.
Синтаксис:
db.collection.insertMany([document1, document2, ...], { ordered: false })
Параметры:
ordered: false: Обозначает неупорядоченную вставку. Даже если вставка одного документа не удалась, это не влияет на вставку других документов.
Пример
{ name: "Henry", age: 60 },
{ name: "Ivy", age: 65 }
], { ordered: false });
Валидация при вставке
MongoDB проверяет вставляемые документы в соответствии с правилами валидации схемы коллекции (если они определены). Если документ не соответствует этим правилам, операция вставки завершится ошибкой.
Предположим, в коллекции users есть правило валидации, требующее, чтобы поле age было больше 0:
db.createCollection("users", {
validator: {
age: { $gt: 0 }
}
});Вставка следующего документа завершится ошибкой:
db.users.insertOne({ name: "John", age: -5 }); // 验证失败 Другие расширения