ドキュメントの挿入

Overview

このガイドでは、MongoDB コレクションにドキュメントを挿入する方法を学習できます。

MongoDB 内のドキュメントを検索、更新、削除する前に、それらを挿入する必要があります。 次の方法を使用して、ドキュメントを挿入できます。

• insert_one() : 1 つのドキュメントを挿入する

• insert_many() : 1 つ以上のドキュメントを挿入する

このガイドには、次のセクションが含まれています。

• _id フィールドは、各ドキュメントに含まれる_idフィールドを記述します

• 「ドキュメントの挿入」では、ドライバーを使用して単一のドキュメントをコレクションに挿入する方法について説明します。

• 「複数のドキュメントの挿入」では、ドライバーを使用して複数のドキュメントをコレクションに挿入する方法について説明します。

• 追加情報では、このガイドで言及されている型とメソッドのリソースとAPIドキュメントへのリンクを提供します

_id フィールド

In MongoDB, each document must contain a unique _id field. MongoDB では、このフィールドを次の方法で管理できます。

• このフィールドを自分で管理し、設定する各_id値が一意であることを確認します。

• ドライバーが一意のObjectId値を自動的に生成できるようにします。 挿入を実行するときに_idフィールドの値を指定しない場合、ドライバーは各ドキュメントに対して一意のObjectId値を生成します。

一意性について強力な保証を提供しない限り、ドキュメントに対して_id値をドライバーに自動的に生成させることをお勧めします。

_idフィールドの詳細については、サーバー マニュアルの「一意のインデックス」を参照してください。

ドキュメント構造とルールの詳細については、サーバー マニュアルのドキュメントを参照してください。

ドキュメントの挿入

単一のドキュメントをコレクションに挿入するには、insert_one() メソッドを使用します。

挿入に成功すると、 メソッドは挿入されたドキュメントの_idを含むInsertOneResultインスタンスを返します。

let my_coll: Collection<Book> = client.database("db").collection("books");
let doc = Book { _id: 8, title: "Atonement".to_string(), author: "Ian McEwan".to_string() };
let insert_one_result = my_coll.insert_one(doc, None).await?;
println!("Inserted document with _id: {}", insert_one_result.inserted_id);

Inserted document with _id: 8

let _opts = InsertOneOptions::builder()
    .bypass_document_validation(true)
    .build();

複数のドキュメントの挿入

複数のドキュメントをコレクションに挿入するには、insert_many() メソッドを使用します。

挿入に成功すると、 メソッドは挿入されたドキュメントの_id値を含むInsertManyResultインスタンスを返します。

let docs = vec![
    Book {
        _id: 5,
        title: "Cat's Cradle".to_string(),
        author: "Kurt Vonnegut Jr.".to_string()
    },
    Book {
        _id: 6,
        title: "In Memory of Memory".to_string(),
        author: "Maria Stepanova".to_string()
    },
    Book {
        _id: 7,
        title: "Pride and Prejudice".to_string(),
        author: "Jane Austen".to_string()
    }
];
let insert_many_result = my_coll.insert_many(docs, None).await?;
println!("Inserted documents with _ids:");
for (_key, value) in &insert_many_result.inserted_ids {
    println!("{:?}", value);
}

Inserted documents with _ids:
Int32(5)
Int32(6)
Int32(7)

let _opts = InsertManyOptions::builder()
    .comment(Some("hello world".into()))
    .build();

{ "_id": 1, "title": "Where the Wild Things Are" }
{ "_id": 2, "title": "The Very Hungry Caterpillar" }
{ "_id": 1, "title": "Blueberries for Sal" }
{ "_id": 3, "title": "Goodnight Moon" }

let docs = vec![
    Book { _id: 1, title: "Where the Wild Things Are".to_string(), author: "".to_string() },
    Book { _id: 2, title: "The Very Hungry Caterpillar".to_string(), author: "".to_string() },
    Book { _id: 4, title: "Blueberries for Sal".to_string(), author: "".to_string() },
    Book { _id: 3, title: "Goodnight Moon".to_string(), author: "".to_string() }
];
let opts = InsertManyOptions::builder().ordered(false).build();
my_coll.insert_many(docs, opts).await?;

{ "_id": 1, "title": "Where the Wild Things Are" }
{ "_id": 2, "title": "The Very Hungry Caterpillar" }
{ "_id": 3, "title": "Goodnight Moon" }

詳細情報

挿入操作の実行可能な例については、次の使用例を参照してください。

• ドキュメントの挿入

• 複数のドキュメントの挿入