ドキュメントの挿入

例

次の例では、 insert_one()メソッドを使用してbooksコレクションにドキュメントを挿入しています。

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).await?;
println!("Inserted document with _id: {}", insert_one_result.inserted_id);

Inserted document with _id: 8

insert_one の動作を変更する

オプション ビルダー メソッドをinsert_one()に連鎖させることで、 insert_one()メソッドの動作を変更できます。 これらのオプション ビルダー メソッドはInsertOneOptions構造体フィールドを設定します。

次の表では、 InsertOneOptionsで利用できるオプションについて説明しています。

次のコードは、 bypass_document_validation()メソッドをinsert_one()メソッドに連結してbypass_document_validationフィールドを設定する方法を示しています。

let _result = my_coll.insert_one(doc)
    .bypass_document_validation(true)
    .await?;

例

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

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).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)

insert_many の動作の変更

オプション ビルダー メソッドをinsert_many()に連鎖させることで、 insert_many()メソッドの動作を変更できます。 これらのオプション ビルダー メソッドはInsertManyOptions構造体フィールドを設定します。

次の表では、 InsertManyOptionsで利用できるオプションについて説明しています。

次のコードは、 comment()メソッドをinsert_many()メソッドに連結してcommentフィールドを設定する方法を示しています。

let _result = my_coll.insert_many(docs)
    .comment(Some("hello world".into()))
    .await?;

順序付き動作の例

たとえば、次のドキュメントをbooksコレクションに挿入するとします。

{ "_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" }

これらのドキュメントを挿入しようとすると、結果は、 ordered()オプション ビルダ メソッドに渡される 値によって異なります。

• true （デフォルト値）の値を渡すと、ドライバは重複した_id値を持つドキュメントを挿入しようとするとBulkWriteErrorをスローします。 ただし、ドライバーはエラーが発生する前にドキュメントを挿入します。

• falseの値を渡した場合でも、重複する_id値を持つドキュメントを挿入しようとしても、ドライバーはBulkWriteErrorをスローしますが、他のすべてのドキュメントが挿入されます。

次のコードは、順序なし書込み操作を実行して前述のドキュメントを挿入する方法を示しています。

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: 1, title: "Blueberries for Sal".to_string(), author: "".to_string() },
    Book { _id: 3, title: "Goodnight Moon".to_string(), author: "".to_string() }
];
my_coll.insert_many(docs).ordered(false).await?;

この操作の結果はBulkWriteErrorになりますが、 コレクション内のエラーが発生していないドキュメントを見つけることができます。

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

API ドキュメント

このガイドで言及されているメソッドとタイプの詳細については、次のAPIドキュメントを参照してください。

• insert_one()

• InsertOneResult

• InsertOneOptions

• insert_many()

• InsertManyResult

• InsertManyOptions

• BulkWriteError

• BulkWriteFailure