문서 삽입

예시

다음 예제에서는 insert_one() 메서드를 사용하여 books collection에 문서를 삽입합니다.

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 collection에 여러 문서를 삽입합니다.

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 collection에 삽입한다고 가정합니다.

{ "_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 이(가) 발생하더라도 collection에서 오류가 발생하지 않는 문서를 찾을 수 있습니다.

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