/ /

문서 삭제

개요

이 가이드에서는 삭제 작업을 사용하여 MongoDB 컬렉션에서 문서를 제거하는 방법에 대해 설명합니다.

샘플 데이터

이 가이드의 예에서는 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# 드라이버 시작하기 를 참조하세요.

삭제 작업

삭제 작업을 사용하여 쿼리 필터와 일치하는 문서를 제거합니다. 쿼리 필터는 쿼리 필터 문서의 기준에 따라 삭제할 레코드를 결정합니다. 다음 방법을 사용하여 MongoDB에서 삭제 작업을 수행할 수 있습니다.

DeleteOne(), 쿼리 필터와 일치하는 첫 번째 문서를 삭제합니다.
DeleteMany(), 쿼리 필터와 일치하는 모든 문서 를 삭제합니다.

문서 하나 삭제

다음 코드는 동기 DeleteOne() 메서드 또는 비동기 DeleteOneAsync() 메서드를 사용하여 문서 하나를 삭제 방법을 보여줍니다.

var result = _restaurantsCollection.DeleteOne(filter);

var result = await _restaurantsCollection.DeleteOneAsync(filter);

여러 문서 삭제

다음 코드는 동기 DeleteMany() 메서드 또는 비동기 DeleteManyAsync() 메서드를 사용하여 일치하는 모든 문서를 삭제 방법을 보여줍니다.

var result = _restaurantsCollection.DeleteMany(filter);

var result = await _restaurantsCollection.DeleteManyAsync(filter);

팁

이러한 메서드를 사용하여 실행할 수 있는 예시는 추가 정보에서 찾아보세요.

매개변수

DeleteOne() 및 DeleteMany() 메서드를 사용하려면 일치시킬 문서를 지정하는 쿼리 필터하다 를 전달해야 합니다. 쿼리 필터하다 를 구성하는 방법에 대한 자세한 내용 은 쿼리 문서 튜토리얼에서 확인할 수 있습니다.

두 메서드 모두 선택적으로 DeleteOptions 유형을 추가 매개 변수로 사용하며, 이는 삭제 작업을 구성하는 데 사용할 수 있는 옵션입니다. DeleteOptions 속성을 지정하지 않으면 운전자 는 삭제 작업을 사용자 지정하지 않습니다.

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

속성	설명
`Collation`	Gets or sets the type of language collation to use when sorting results. See the Collation section of this page for more information.
`Comment`	작업에 대한 주석을 가져오거나 설정합니다. 자세한 내용은 삭제 명령 필드를 참조하세요.
`Hint`	문서를 스캔할 때 사용할 인덱스를 가져오거나 설정합니다. 자세한 내용은 삭제 성명서를 참조하세요.
`Let`	허용 문서를 가져오거나 설정합니다. 자세한 내용은 삭제 명령 필드를 참조하세요.

데이터 정렬

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

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

Parameter	설명	클래스 속성
`locale`	Specifies the International Components for Unicode (ICU) locale. For a list of supported locales, see Collation Locales and Default Parameters in the MongoDB Server Manual. If you want to use simple binary comparison, use the `Collation.Simple` static property to return a `Collation` object with the `locale` set to `"simple"`. Data Type: `string`	`Locale`
`caseLevel`	(선택 사항) 대/소문자 비교 포함 여부를 지정합니다. 이 인수가 `true`인 경우 드라이버의 동작은 `strength` 인수의 값에 따라 달라집니다. - `strength` 가 `CollationStrength.Primary`인 경우 드라이버는 기본 문자와 대소문자를 비교합니다. - `strength` 가 `CollationStrength.Secondary`인 경우 드라이버는 기본 문자, 발음 부호, 기타 세컨더리 차이 및 대소문자를 비교합니다. - `strength` 이 기타 값인 경우 이 인수는 무시됩니다. 이 인수가 `false`인 경우 드라이버는 `Primary` 또는 `Secondary` 수준의 강도에서 대소문자 비교를 포함하지 않습니다. 데이터 유형: `boolean` 기본값: `false`	`CaseLevel`
`caseFirst`	(Optional) Specifies the sort order of case differences during tertiary level comparisons. Data Type: CollationCaseFirst Default: `CollationCaseFirst.Off`	`CaseFirst`
`strength`	(Optional) Specifies the level of comparison to perform, as defined in the ICU documentation. Data Type: CollationStrength Default: `CollationStrength.Tertiary`	`Strength`
`numericOrdering`	(선택 사항) `true`102운전자 숫자 문자열을 숫자로 비교할지 여부를 지정합니다.10 이 2 인수가 10 이면 `false` 운전자 숫자 문자열을 숫자로 비교합니다. 예시 들어,10" " 및 & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & & &2& & & & & & & & &1& & & & & & &2& & & & & & & & & & & & " & " 이 인수가10이거나 제외되면 운전자 숫자 문자열을2문자열로 비교합니다. 예시 들어, " " 및 & "", 운전자 한 번에 한 문자씩 비교합니다. " " 가 " "보다 작으면 운전자 " " " "보다 작아야 합니다. 자세한 내용은 MongoDB Server 매뉴얼에서 데이터 정렬 제한을 참조하세요. 데이터 유형: `boolean` 기본값: `false`	`NumericOrdering`
`alternate`	(Optional) Specifies whether the driver considers whitespace and punctuation as base characters for purposes of comparison. Data Type: CollationAlternate Default: `CollationAlternate.NonIgnorable` (spaces and punctuation are considered base characters)	`Alternate`
`maxVariable`	(Optional) Specifies which characters the driver considers ignorable when the `alternate` argument is `CollationAlternate.Shifted`. Data Type: CollationMaxVariable Default: `CollationMaxVariable.Punctuation` (the driver ignores punctuation and spaces)	`MaxVariable`
`normalization`	(Optional) Specifies whether the driver normalizes text as needed. Most text doesn't require normalization. For more information about normalization, see the ICU documentation. Data Type: `boolean` Default: `false`	`Normalization`
`backwards`	(선택 사항) 분음 부호가 포함된 string이 string의 뒤쪽에서 앞쪽으로 정렬되는지 지정합니다. 데이터 유형: `boolean` 기본값: `false`	`Backwards`

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

예시

다음 코드는 Atlas Search 메서드를 사용하여 DeleteMany() "borough_1" 인덱스를 검색하고 address.street 필드 값에 "Pearl Street" 문구가 포함된 모든 문서를 삭제합니다.

var filter = Builders<Restaurant>.Filter
    .Regex("address.street", "Pearl Street");
DeleteOptions opts = new DeleteOptions { Hint = "borough_1" };
Console.WriteLine("Deleting documents...");
var result = _restaurantsCollection.DeleteMany(filter, opts);
Console.WriteLine($"Deleted documents: {result.DeletedCount}");
Console.WriteLine($"Result acknowledged? {result.IsAcknowledged}");

Deleting documents...
Deleted documents: 26
Result acknowledged? True

팁

앞의 예시 에서 DeleteMany() 대신 DeleteOne() 메서드를 사용한 경우 운전자 는 26 일치하는 문서 중 첫 번째 문서를 삭제 합니다.

반환 값

DeleteOne() 및 DeleteMany() 메서드는 DeleteResult 유형을 반환합니다. 이 유형에는 삭제된 문서 수를 나타내는 DeletedCount 속성 과 결과가 승인되었는지 여부를 나타내는 IsAcknowledged 속성 이 포함됩니다. 쿼리 필터하다 가 어떤 문서와도 일치하지 않으면 문서가 삭제되지 않고 DeletedCount 는 0 이 됩니다.

추가 정보

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

API 문서

이 가이드에서 설명하는 메서드나 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.

돌아가기

문서 교체

대량 쓰기 작업