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: "New York"
});

戻り値:

{
    "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() は非推奨(deprecated)としてマークされており、公式では 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 以降で非推奨(deprecated)としてマークされており、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 }); // 验证失败
その他の拡張