문서 삽입

개요

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

MongoDB에서 문서를 찾고, 업데이트하고, 삭제하려면 먼저 해당 문서를 삽입해야 합니다. InsertOne() 메서드를 사용하여 하나의 문서를 삽입하거나 InsertMany() 또는 BulkWrite() 메서드를 사용하여 여러 문서를 삽입할 수 있습니다.

다음 섹션에서는 InsertOne() 및 InsertMany()에 중점을 둡니다. BulkWrite() 메서드 사용 방법을 알아보려면 대량 작업 가이드를 참조하세요.

필드 _id

MongoDB에서는 각 문서에 고유한 _id 필드가 포함되어야 합니다 .

이 필드를 관리하기 위한 옵션 두 가지는 다음과 같습니다.

• 이 필드를 직접 관리하여 사용하는 각 값이 고유한지 확인하세요.

• 드라이버가 고유한 ObjectId 값을 자동으로 생성하도록 합니다. 드라이버는 _id를 명시적으로 지정하지 않은 문서에 대해 고유한 ObjectId 값을 생성합니다.

고유성을 강력하게 보장하지 않는 한 MongoDB는 드라이버가 _id 값을 자동으로 생성하도록 할 것을 권장합니다.

_id 필드에 대해 자세히 알아보려면 고유 인덱스에 대한 서버 매뉴얼 항목을 참조하세요.

문서 구조 및 규칙에 대해 자세히 알아보려면 문서에대한 서버 수동 항목을 참조하세요.

문서 삽입

단일 문서를 컬렉션에 삽입하려면 InsertOne() 메서드를 사용합니다.

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

type Book struct {
	Title  string
	Author string
}

coll := client.Database("db").Collection("books")
doc := Book{Title: "Atonement", Author: "Ian McEwan"}
result, err := coll.InsertOne(context.TODO(), doc)
fmt.Printf("Inserted document with _id: %v\n", result.InsertedID)

opts := options.InsertOne().SetBypassDocumentValidation(true)

여러 문서를 삽입합니다.

여러 문서를 컬렉션에 삽입하려면 InsertMany() 메서드를 사용합니다.

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

coll := client.Database("myDB").Collection("favorite_books")
docs := []interface{}{
    Book{Title: "Cat's Cradle", Author: "Kurt Vonnegut Jr."},
    Book{Title: "In Memory of Memory", Author: "Maria Stepanova"},
    Book{Title: "Pride and Prejudice", Author: "Jane Austen"},
}
result, err := coll.InsertMany(context.TODO(), docs)
fmt.Printf("Documents inserted: %v\n", len(result.InsertedIDs))
for _, id := range result.InsertedIDs {
    fmt.Printf("Inserted document with _id: %v\n", id)
}

Documents inserted: 3
Inserted document with _id: ObjectID("...")
Inserted document with _id: ObjectID("...")
Inserted document with _id: ObjectID("...")

opts := options.InsertMany().SetBypassDocumentValidation(true).SetOrdered(false)

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

type Book struct {
    ID    int `bson:"_id"`
    Title string
}
...
docs := []interface{}{
    Book{ID: 1, Title: "Where the Wild Things Are"},
    Book{ID: 2, Title: "The Very Hungry Caterpillar"},
    Book{ID: 1, Title: "Blueberries for Sal"},
    Book{ID: 3, Title: "Goodnight Moon"},
}
result, err := coll.InsertMany(context.TODO(), docs)
if err != nil {
    fmt.Printf("A bulk write error occurred, but %v documents were still inserted.\n", len(result.InsertedIDs))
}
for _, id := range result.InsertedIDs {
    fmt.Printf("Inserted document with _id: %v\n", id)
}

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

추가 정보

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

• 문서 삽입

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

언급된 작업을 수행하는 방법에 대해 자세히 알아보려면 다음 가이드를 참조하세요:

• 쿼리 지정

• 대량 작업