문서 삽입

인터랙티브 튜토리얼 열기

개요

이 가이드에서는 MongoDB .NET/C# 드라이버를 사용해서 삽입 작업을 수행하여 MongoDB 컬렉션에 문서를 추가하는 방법에 대해 설명합니다.

삽입 작업은 하나 이상의 문서를 MongoDB 컬렉션에 삽입하는 작업입니다. .NET/C# 드라이버는 삽입 작업을 수행하는 다음과 같은 메서드를 제공합니다. 각 메서드에는 비동기 및 동기 버전이 있습니다.

• InsertOneAsync() or InsertOne()

• InsertManyAsync() or InsertMany()

public class Restaurant
{
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    [BsonElement("restaurant_id")]
    public string RestaurantId { get; set; }
    public string Cuisine { get; set; }
    public Address Address { get; set; }
    public string Borough { get; set; }
    public List<GradeEntry> Grades { get; set; }
}

public class Address
{
    public string Building { get; set; }
    [BsonElement("coord")]
    public double[] Coordinates { get; set; }
    public string Street { get; set; }
    [BsonElement("zipcode")]
    public string ZipCode { get; set; }
}

public class GradeEntry
{
    public DateTime Date { get; set; }
    public string Grade { get; set; }
    public float? Score { get; set; }
}

필드 _id

MongoDB 컬렉션에서 각 문서에는 고유한 필드 값이 있는 _id 필드가 포함되어야 합니다.

MongoDB를 사용하면 이 필드를 두 가지 방법으로 관리할 수 있습니다.

• 각 _id 필드 값이 고유하도록 각 문서에 대해 이 필드를 직접 설정할 수 있습니다.

• 드라이버가 각 문서 _id에 대해 고유한 ObjectId 값을 자동으로 생성하도록 할 수 있습니다. 문서에 대해 _id 필드 값을 수동으로 설정하지 않으면 드라이버는 필드를 ObjectId로 채웁니다.

고유성을 보장할 수 없을 경우, MongoDB 드라이버가 _id 값을 자동으로 생성하도록 하는 것이 좋습니다.

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

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

문서 하나 삽입

다음 코드는 비동기 InsertOneAsync() 메서드 또는 동기 InsertOne() 메서드를 사용하여 단일 문서를 삽입하는 방법을 보여줍니다.

await _restaurantsCollection.InsertOneAsync(document);

_restaurantsCollection.InsertOne(document);

여러 문서를 삽입합니다.

다음 코드는 비동기 InsertManyAsync() 메서드 또는 동기 InsertMany() 메서드를 사용하여 여러 문서를 삽입하는 방법을 보여줍니다.

await _restaurantsCollection.InsertManyAsync(docs);

_restaurantsCollection.InsertMany(docs);

삽입 동작 수정

InsertOne() 메서드는 삽입하려는 문서를 매개 변수로 사용합니다. InsertMany() 메서드는 목록이나 배열과 같은 문서의 IEnumerable 컬렉션을 매개 변수로 사용합니다.

InsertOne() 메서드는 선택적으로 InsertOneOptions 유형을 추가적인 매개 변수로 사용하며, 이는 삽입 작업을 구성하는 데 사용할 수 있는 옵션입니다. InsertOneOptions 속성을 지정하지 않으면 드라이버가 삽입을 사용자 지정하지 않습니다.

InsertOneOptions 유형을 사용하면 다음과 같은 속성을 가진 옵션을 구성할 수 있습니다.

InsertMany() 메서드는 앞에 설명한 BypassDocumentValidation 및 Comment 속성과 추가적인 IsOrdered 속성이 있는 추가 매개 변수로 InsertManyOptions 유형을 선택적으로 사용합니다.

var restaurantsList = new List<Restaurant>()
{
    new() { Name = "Été Bleu", Cuisine = "French" },
    new() { Name = "Lucky Bird", Cuisine = "Café/Coffee/Tea" },
    new() { Name = "Wildflower Café", Cuisine = "Vegetarian" },
    new() { Name = "Blue Moon Grill", Cuisine = "American" },
};
var options = new InsertManyOptions() { BypassDocumentValidation = true };
Console.WriteLine("Inserting documents...");
_restaurantsCollection.InsertMany(restaurantsList, options);

순서 지정된 동작 지정

다음 문서를 삽입한다고 가정합니다:

{ "_id" : 1, "name" : "Restaurant A" }
{ "_id" : 2, "name" : "Restaurant B" }
{ "_id" : 1, "name" : "Restaurant C" }
{ "_id" : 3, "name" : "Restaurant D" }

기본 InsertManyOptions를 통해 이러한 문서를 삽입하려고 하면 반복되는 _id 값으로 인해 세 번째 문서에서 MongoBulkWriteException이 발생하지만 오류가 발생한 문서 앞의 문서는 여전히 컬렉션에 삽입됩니다.

컬렉션 내부를 살펴보면 다음 문서를 볼 수 있습니다.

{ "_id" : 1, "name" : "Restaurant A" }
{ "_id" : 2, "name" : "Restaurant B" }

삽입 작업에서 IsOrdered를 false로 설정하면 일부 문서에서 오류가 발생하더라도 드라이버는 문서를 계속 삽입합니다. 이렇게 수정된 삽입 동작을 사용하면 드라이버에서 예외가 발생하지만 오류가 발생하지 않는 모든 문서를 삽입합니다.

컬렉션 내부를 살펴보면 다음 문서를 볼 수 있습니다.

{ "_id" : 1, "name" : "Restaurant A" }
{ "_id" : 2, "name" : "Restaurant B" }
{ "_id" : 3, "name" : "Restaurant D" }

추가 정보

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

• 문서 삽입

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