MongoDB Вставка документов

В этой главе мы покажем вам, как вставлять данные в коллекции MongoDB.

Структура данных документов в основном совпадает с JSON.

Все данные, хранящиеся в коллекциях, представлены в формате BSON.

BSON — это двоичный формат хранения, похожий на JSON, сокращение от Binary JSON.

К распространённым методам вставки документов относятся:

МетодНазначениеУстаревший?
insertOne()Вставка одного документанет
insertMany()Вставка нескольких документовнет
insert()Вставка одного или нескольких документовДа
save()Вставка или обновление документаДа

1、insertOne()

Метод insertOne() используется для вставки одного документа в коллекцию.

db.collection.insertOne(document, options)
  • document: вставляемый документ.
  • options (необязательно): Необязательный объект параметров, который может включать writeConcern, bypassDocumentValidation и т. д.

Пример

db.myCollection.insertOne({
    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: Обозначает неупорядоченную вставку. Даже если вставка одного документа не удалась, это не влияет на вставку других документов.

Пример

db.users.insertMany([
  { 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 }); // 验证失败
Другие расширения