/ /

문서 교체

개요

이 가이드 에서는 .NET/ C# 드라이버 사용하여 MongoDB 컬렉션 의 문서를 교체하는 방법을 학습 수 있습니다.

.NET/ C# 드라이버 ReplaceOne() 및 ReplaceOneAsync() 메서드를 제공합니다. 이 메서드는 검색 기준과 일치하는 첫 번째 문서 에서 모든 필드( _id 필드 제외)를 제거 다음 지정한 필드와 값을 문서 에 삽입합니다.

참고

메서드 오버로드

이 페이지의 많은 메서드에는 여러 개의 오버로드가 있습니다. 이 가이드 의 예제에서는 각 메서드에 대한 정의를 하나만 보여줍니다. 사용 가능한 오버로드에 대한 자세한 내용은 API 설명서를 참조하세요.

샘플 데이터

이 가이드의 예에서는 sample_restaurants 데이터베이스의 restaurants 컬렉션을 사용합니다. 이 컬렉션의 문서는 다음 Restaurant, Address, GradeEntry 클래스를 모델로 사용합니다.

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

참고

restaurants 컬렉션 의 문서는 대소문자 명명 규칙을 사용합니다. 이 가이드 의 예제에서는 ConventionPack 를 사용하여 컬렉션 의 필드를 파스칼식 대/소문자로 역직렬화하고 Restaurant 클래스의 속성에 매핑합니다.

사용자 지정 직렬화에 대해 자세히 알아보려면 사용자 지정 직렬화를참조하세요.

이 컬렉션 Atlas 에서 제공하는 샘플 데이터 세트에서 가져온 것입니다. 무료 MongoDB cluster 생성하고 이 샘플 데이터를 로드하는 방법을 학습 .NET/ C# 드라이버 시작하기 를 참조하세요.

하나의 문서 바꾸기

컬렉션 의 문서 바꾸려면 ReplaceOne() 또는 ReplaceOneAsync() 메서드를 호출합니다. 이러한 메서드는 다음 매개변수를 허용합니다.

Parameter	설명
`filter`	바꿀 문서 지정하는 쿼리 필터하다 입니다. `Builders` 클래스를 사용하여 쿼리 필터하다 만들 수 있습니다. 쿼리 필터에 대한 자세한 내용은 MongoDB Server 매뉴얼을 참조하세요. 데이터 유형: FilterDefinition<TDocument>
`replacement`	새 문서에 삽입할 필드와 값을 지정하는 대체 문서입니다. 컬렉션의 문서가 C# 클래스에 매핑된 경우 대체 문서는 이 클래스의 인스턴스가 될 수 있습니다. 데이터 유형: `TDocument`
`options`	선택 사항. 바꾸기 작업에 대한 구성을 지정하는 `ReplaceOptions` 클래스의 인스턴스 . 기본값 은 `null`입니다. 데이터 유형: ReplaceOptions
`cancellationToken`	선택 사항. 작업을 취소하는 데 사용할 수 있는 토큰입니다. 데이터 유형: CancellationToken

다음 코드 예시 바꾸기 작업을 수행하는 방법을 보여 줍니다. 이 코드는 다음 단계를 수행합니다.

Builders 클래스를 사용하여 쿼리 필터하다 만듭니다. 이 필터하다 cuisine 필드 값이 "Pizza"인 모든 문서와 일치합니다.
새 Restaurant 객체 만듭니다.
restaurants 컬렉션 에서 ReplaceOne() 메서드를 호출합니다. 이 작업은 컬렉션 에서 일치하는 첫 번째 문서 찾아 새로 만든 문서 로 바꿉니다.

Synchronous 또는 Asynchronous 탭을 선택하여 해당 코드를 확인합니다.

// Creates a filter for all restaurant documents that have a "cuisine" value of "Pizza"
var filter = Builders<Restaurant>.Filter
    .Eq(r => r.Cuisine, "Pizza");
// Finds the ID of the first restaurant document that matches the filter
var oldPizzaRestaurant = _restaurantsCollection.Find(filter).First();
var oldId = oldPizzaRestaurant.Id;
// Generates a new restaurant document
Restaurant newPizzaRestaurant = new()
{
    Id = oldId,
    Name = "Mongo's Pizza",
    Cuisine = "Pizza",
    Address = new Address()
    {
        Street = "Pizza St",
        ZipCode = "10003"
    },
    Borough = "Manhattan",
};
// Replaces the existing restaurant document with the new document
return _restaurantsCollection.ReplaceOne(filter, newPizzaRestaurant);

// Creates a filter for all restaurant documents that have a "cuisine" value of "Pizza"
var filter = Builders<Restaurant>.Filter
    .Eq(r => r.Cuisine, "Pizza");
// Finds the ID of the first restaurant document that matches the filter
var oldPizzaRestaurant = _restaurantsCollection.Find(filter).First();
var oldId = oldPizzaRestaurant.Id;
// Generates a new restaurant document
Restaurant newPizzaRestaurant = new()
{   
    Id = oldId,
    Name = "Mongo's Pizza",
    Cuisine = "Pizza",
    Address = new Address()
    {
        Street = "Pizza St",
        ZipCode = "10003"
    },
    Borough = "Manhattan",
};
// Asynchronously replaces the existing restaurant document with the new document
return await _restaurantsCollection.ReplaceOneAsync(filter, newPizzaRestaurant);

중요

_id 필드의 값은 변경할 수 없습니다. 대체 문서에서 _id 필드 값을 지정하는 경우 기존 문서의 _id 값과 일치해야 합니다.

교체 문서 _id 필드 의 값이 지정되지 않은 경우 POCO(Plain Old CLR/Class Object)의 _id 필드 에 [BsonIgnoreIfDefault] 속성을 추가할 수 있습니다. POCO의 _id 필드 ObjectId 유형인 경우 [BsonIgnoreIfDefault] 를 사용합니다.

다음 예시 이 속성을 추가하는 방법을 보여줍니다.

public class Restaurant
{
    [BsonIgnoreIfDefault]
    public ObjectId Id { get; set; }
    // Other properties
}

대체 작업 사용자 지정

ReplaceOne() 및 ReplaceOneAsync() 메서드는 선택적으로 ReplaceOptions 객체 매개 변수로 허용하며, 이는 대체 작업을 구성하는 데 사용할 수 있는 옵션을 나타냅니다.

ReplaceOptions 클래스에는 다음과 같은 속성이 포함되어 있습니다.

속성

설명

BypassDocumentValidation

바꾸기 작업에서 문서 유효성 검사 우회할지 여부를 지정합니다. 이를 통해 스키마 유효성 검사 요구 사항을 충족하지 않는 문서(있는 경우)를 대체할 수 있습니다. 스키마 유효성 검사 에 대한 자세한 내용은 MongoDB Server 매뉴얼을 참조하세요.

데이터 유형: bool?

Collation

결과를 정렬할 때 사용할 언어 데이터 정렬의 종류를 지정합니다. 자세한 내용은 이 페이지의 데이터 정렬 섹션을 참조하세요.

데이터 유형: 데이터 정렬

Comment

작업에 대해 사용자가 제공한 설명을 가져오거나 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼을 참조하세요.

데이터 유형: BsonValue

Hint

문서를 스캔하는 데 사용할 인덱스 를 가져오거나 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼을 참조하세요.

데이터 유형: BsonValue

IsUpsert

쿼리 필터하다 와 일치하는 문서가 없는 경우 대체 작업에서 업서트 작업을 수행할지 여부를 지정합니다. 자세한 내용은 MongoDB Server 매뉴얼을 참조하세요.

데이터 유형: bool

Sort

대체 작업 문서 지정된 정렬 순서의 첫 번째 문서 대체하기 때문에 쿼리 여러 문서를 선택하는 경우 작업에서 대체할 문서를 결정합니다. 이 옵션을 설정하다 하려면 다음 코드와 같이 데이터를 모델링하는 일반 유형을 사용하는 ReplaceOptions<T> 인스턴스 인스턴스화해야 합니다.

var options = new ReplaceOptions<Restaurant>
{
  Sort = Builders<Restaurant>.Sort.Ascending(r => r.Name)
};

데이터 유형: SortDefinition<T>

Let

let 문서 가져오거나 설정합니다. 자세한 내용은 MongoDB Server 매뉴얼을 참조하세요.

데이터 유형: BsonDocument

다음 예시 앞의 예시 와 동일한 단계를 수행하지만 BypassDocumentValidation 옵션을 사용하여 스키마 유효성 검사 요구 사항을 우회합니다. Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

// Creates a filter for all restaurant documents that have a "cuisine" value of "Pizza"
var filter = Builders<Restaurant>.Filter
    .Eq(r => r.Cuisine, "Pizza");
// Finds the ID of the first restaurant document that matches the filter
var oldPizzaRestaurant = _restaurantsCollection.Find(filter).First();
var oldId = oldPizzaRestaurant.Id;
// Generates a new restaurant document
Restaurant newPizzaRestaurant = new()
{
    Id = oldId,
    Name = "Mongo's Pizza",
    Cuisine = "Pizza",
    Address = new Address()
    {
        Street = "Pizza St",
        ZipCode = "10003"
    },
    Borough = "Manhattan",
};
var options = new ReplaceOptions
{
    BypassDocumentValidation = true
};
// Replaces the existing restaurant document with the new document
return _restaurantsCollection.ReplaceOne(filter, newPizzaRestaurant, options);

// Creates a filter for all restaurant documents that have a "cuisine" value of "Pizza"
var filter = Builders<Restaurant>.Filter
    .Eq(r => r.Cuisine, "Pizza");
// Finds the ID of the first restaurant document that matches the filter
var oldPizzaRestaurant = _restaurantsCollection.Find(filter).First();
var oldId = oldPizzaRestaurant.Id;
// Generates a new restaurant document
Restaurant newPizzaRestaurant = new()
{
    Id = oldId,
    Name = "Mongo's Pizza",
    Cuisine = "Pizza",
    Address = new Address()
    {
        Street = "Pizza St",
        ZipCode = "10003"
    },
    Borough = "Manhattan",
};
var options = new ReplaceOptions
{
    BypassDocumentValidation = true
};
// Asynchronously replaces the existing restaurant document with the new document
return await _restaurantsCollection.ReplaceOneAsync(filter, newPizzaRestaurant, options);

데이터 정렬

작업에 대한 데이터 정렬을 구성하려면 데이터 정렬 클래스의 인스턴스를 만듭니다.

다음 표에서는 Collation 생성자가 허용하는 매개변수에 대해 설명합니다. 또한 각 설정의 값을 읽는 데 사용할 수 있는 해당 클래스 속성 도 나열되어 있습니다.

Parameter	설명	클래스 속성
`locale`	유니코드용 국제 구성 요소(ICU) 국가 및 언어 설정 및 언어 설정을 지정합니다. 지원되는 국가 및 언어 설정 목록은 MongoDB Server `Collation.Simple` `Collation` `locale` `"simple"`매뉴얼의 데이터 정렬 국가 및 언어 설정 및 기본 매개변수를 참조하세요. 단순 이진 비교를 사용하려면 정적 속성 사용하여 가 로 설정하다 객체 반환합니다. 데이터 유형: `string`	`Locale`
`caseLevel`	(선택 사항) 대소문자 비교를 포함할지 여부를 지정합니다. 이 인수가 인 경우 `true` 드라이버의 동작은 인수의 값에 따라 달라집니다.`strength` - 가 인 경우 `strength` `CollationStrength.Primary`운전자 기본 문자와 대소문자를 비교합니다. - 가 `strength` `CollationStrength.Secondary`인 경우 운전자 기본 문자, 분음 부호, 기타 세컨더리 차이점 및 대소문자를 비교합니다. - `strength` 이 다른 값인 경우 이 인수는 무시됩니다. 이 인수가 인 `false` 경우 운전자 강도 수준 `Primary` 또는 에서 대소문자 비교를 포함하지 `Secondary` 않습니다. 데이터 유형: `boolean` 기본값: `false`	`CaseLevel`
`caseFirst`	(선택 사항) 3차 수준 비교 시 대소문자 차이의 정렬 순서를 지정합니다. 데이터 유형: CollationCaseFirst 기본값: `CollationCaseFirst.Off`	`CaseFirst`
`strength`	(선택 사항) ICU 문서에 정의된 대로 수행할 비교 수준을 지정합니다. 데이터 유형: CollationStrength 기본값: `CollationStrength.Tertiary`	`Strength`
`numericOrdering`	(선택 사항) 운전자 숫자 문자열을 숫자로 비교할지 여부를 지정합니다. 이 인수가 `true` 이면 운전자 숫자 문자열을 숫자로 비교합니다. 예시 를 들어 "10문자열과 "2" 문자열을 비교할 때 운전자 값을 10 및 로 2 처리하고 가 10 더 큰 것을 찾습니다. 이 인수가 `false` 이거나 제외되면 운전자 숫자 문자열을 문자열로 비교합니다. 예시 를 들어10문자열과 '2' 문자열을 비교할 때 운전자 한 번에 한 문자씩 비교합니다. '1'는 ' '보다 작으므로2운전자 '10'이 ' '보다 작은 것을2찾습니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬 제한을 참조하세요. 데이터 유형: `boolean` 기본값: `false`	`NumericOrdering`
`alternate`	(선택 사항) 운전자 비교를 위해 공백과 문장 부호를 기본 문자로 간주할지 여부를 지정합니다. 데이터 유형: CollationAlternate 기본값:(공백과 `CollationAlternate.NonIgnorable` 문장 부호는 기본 문자로 간주됨)	`Alternate`
`maxVariable`	(선택 사항) 인수가 일 때 운전자 무시할 수 있는 것으로 간주하는 `alternate` `CollationAlternate.Shifted`문자를 지정합니다. 데이터 유형: CollationMaxVariable 기본값:( `CollationMaxVariable.Punctuation` 운전자 구두점 및 공백 무시)	`MaxVariable`
`normalization`	(선택 사항) 운전자 필요에 따라 텍스트를 정규화할지 여부를 지정합니다. 대부분의 텍스트에는 정규화가 필요하지 않습니다. 정규화에 대한 자세한 내용은 ICU 문서를 참조하세요. 데이터 유형: 기본값: `boolean` `false`	`Normalization`
`backwards`	(선택 사항) 분음 부호가 포함된 문자열을 문자열 뒤쪽에서 앞쪽으로 정렬할지 여부를 지정합니다. 데이터 유형: `boolean` 기본값: `false`	`Backwards`

데이터 정렬에 대한 자세한 내용은 MongoDB Server 매뉴얼의 데이터 정렬 페이지를 참조하세요.

반환 값

ReplaceOne() 메서드는 ReplaceOneResult 객체 반환하고 ReplaceOneAsync() 메서드는 Task<ReplaceOneResult> 객체 반환합니다. ReplaceOneResult 클래스에는 다음과 같은 속성이 포함되어 있습니다.

속성	설명
`IsAcknowledged`	MongoDB에서 대체 작업을 승인했는지 여부를 나타냅니다. 데이터 유형: `bool`
`IsModifiedCountAvailable`	`ReplaceOneResult`에서 대체된 기록 수를 읽을 수 있는지 여부를 나타냅니다. 데이터 유형: `bool`
`MatchedCount`	쿼리 필터가 대체되었는지 여부에 관계없이 쿼리 필터와 일치하는 문서 수입니다. 데이터 유형: `long`
`ModifiedCount`	대체 작업으로 바뀐 문서 수입니다. 데이터 유형: `long`
`UpsertedId`	드라이버가 업서트를 수행한 경우 데이터베이스에 업서트된 문서의 ID입니다. 데이터 유형: BsonValue

추가 정보

대체 작업의 실행 가능한 예제는 다음 사용 예제를 참조하세요.

API 문서

이 페이지에 사용된 메서드 및 클래스에 대해 자세히 학습 다음 API 설명서를 참조하세요.

돌아가기

배열

문서 삭제