문서 삽입

개요

이 가이드에서는 MongoDB 컬렉션에 문서를 삽입하는 방법을 배울 수 있습니다.

MongoDB에서 문서를 찾고, 업데이트하고, 삭제하려면 먼저 문서를 삽입해야 합니다. 다음 방법을 사용하여 문서를 삽입할 수 있습니다.

• insert_one() 하나의 문서를 삽입하려면

• insert_many() 하나 이상의 문서를 삽입하려면

이 가이드에는 다음 섹션이 포함되어 있습니다.

• _id 필드 는 각 문서에 포함된 _id 필드를 설명합니다.

• 문서 삽입 에서는 드라이버를 사용하여 컬렉션에 단일 문서를 삽입하는 방법을 설명합니다.

• 여러 문서 삽입 에서는 드라이버를 사용하여 컬렉션에 여러 문서를 삽입하는 방법을 설명합니다.

• 추가 정보에서 이 가이드에 언급된 유형 및 메소드에 대한 리소스 및 API 문서 링크를 찾을 수 있습니다.

_id 필드

MongoDB에서 각 문서에는 고유한 _id 필드가 포함 되어야 합니다. MongoDB를 사용하면 다음과 같은 방법으로 이 필드를 관리할 수 있습니다.

• 이 필드를 직접 관리하여 설정한 각 _id 값이 고유한지 확인합니다.

• 드라이버가 고유한 ObjectId 값을 자동으로 생성하도록 합니다. 삽입을 수행할 때 _id 필드에 값을 지정하지 않으면 드라이버는 각 문서에 대해 고유한 ObjectId 값을 생성합니다.

고유성에 대한 강력한 보장을 제공하지 않는 한 드라이버가 문서에 대해 _id 값을 자동으로 생성하도록 하는 것이 좋습니다.

_id 필드에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 고유 인덱스 를 참조하세요.

문서 구조 및 규칙에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 문서 를 참조하세요.

문서 삽입

단일 문서를 컬렉션에 삽입하려면 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() 메서드를 사용합니다.

성공적으로 삽입되면 메서드는 InsertManyResult _id 삽입된 문서의 값이 포함된 인스턴스를 반환합니다.

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

추가 정보

삽입 작업의 실행 가능한 예시는 다음 사용 예시를 참조하세요:

• 문서 삽입

• 여러 문서를 삽입합니다.