/ /

고유 필드 값 검색

개요

이 가이드 에서는 .NET/ C# 드라이버 사용하여 컬렉션 전체에서 지정된 필드 의 고유 값을 조회 방법을 학습 수 있습니다.

컬렉션 내에서 서로 다른 문서에 단일 필드 에 대해 서로 다른 값이 포함될 수 있습니다. 예시 들어 restaurants 컬렉션 의 한 문서 borough 값이 "Manhattan"이고 다른 문서의 borough 값은 "Queens"입니다. .NET/ C# 드라이버 사용하면 컬렉션 의 여러 문서에서 필드 에 포함된 고유 값을 모두 조회 할 수 있습니다.

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트의 sample_restaurants.restaurants 컬렉션 사용합니다. 무료 MongoDB Atlas cluster 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 .NET/ C# 드라이버 시작하기를 참조하세요.

이 페이지의 예제에서는 다음 Restaurant 클래스를 사용하여 컬렉션 의 문서를 모델링합니다.

public class Restaurant {
    public ObjectId? Id { get; set; }
    [BsonElement("name")]
    public string? Name { get; set; }
    [BsonElement("cuisine")]
    public string? Cuisine { get; set; }
    [BsonElement("borough")]
    public string? Borough { get; set; }
}

Retrieve Distinct Values

지정된 필드 의 고유 값을 조회 하려면 IMongoCollection<TDocument> 인스턴스 의 Distinct() 또는 DistinctAsync() 메서드를 호출하고 고유 값을 찾으려는 필드 의 이름을 전달합니다.

컬렉션 전체에서 값 검색

다음 예시 restaurants 컬렉션 에 있는 borough 필드 의 고유 값을 검색합니다. Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

var results = collection.Distinct<string>(r => r.Borough, Builders<Restaurant>.Filters.Empty).ToList();
foreach (var result in results)
{
    Console.WriteLine(result);
}

Bronx
Brooklyn
Manhattan
Missing
Queens
Staten Island

var results = await collection.DistinctAsync<string>(r => r.Borough, Builders<Restaurant>.Filters.Empty);
await results.ForEachAsync(result => Console.WriteLine(result));

Bronx
Brooklyn
Manhattan
Missing
Queens
Staten Island

이 작업은 각 고유 borough 필드 값 액세스 위해 반복할 수 있는 커서 반환합니다. 여러 문서가 borough 필드 에 동일한 값을 가지고 있더라도 각 값은 결과에 한 번만 표시됩니다.

지정된 문서에서 값 검색

Distinct() 및 DistinctAsync() 메서드에 쿼리 필터 를 제공하여 컬렉션의 문서 하위 집합 내에서 고유한 필드 값을 찾을 수 있습니다. 쿼리 필터하다 는 작업에서 문서를 일치시키는 데 사용되는 검색 기준을 지정하는 표현식 입니다. 쿼리 필터 만들기에 대한 자세한 내용은 쿼리 필터 만들기 가이드를 참조하세요.

다음 예시 cuisine 필드 값이 "Italian"인 모든 문서에 대해 borough 필드 의 고유 값을 검색합니다. Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

var filter = Builders<Restaurant>.Filter.Eq(r => r.Cuisine, "Italian");
var results = collection.Distinct<string>(r => r.Borough, filter).ToList();
foreach (var result in results)
{
    Console.WriteLine(result);
}

var filter = Builders<Restaurant>.Filter.Eq(r => r.Cuisine, "Italian");
var results = await collection.DistinctAsync<string>(r => r.Borough, filter);
await results.ForEachAsync(result => Console.WriteLine(result));

고유 동작 수정

DistinctOptions 인스턴스 선택적 매개변수로 제공하여 Distinct() 및 DistinctAsync() 메서드의 동작을 수정할 수 있습니다. 다음 표에서는 DistinctOptions 인스턴스 에 설정하다 수 있는 속성에 대해 설명합니다.

메서드	설명
`Collation`	작업에 사용할 데이터 정렬을 설정합니다. 자세한 내용은 이 페이지의 데이터 정렬 섹션을 참조하세요. 기본값: `null` 데이터 유형: 데이터 정렬
`MaxTime`	작업을 실행할 수 있는 최대 시간을 설정합니다. 데이터 유형: `TimeSpan`
`Comment`	작업에 댓글을 첨부합니다. 데이터 유형: BsonValue 또는 `string`

다음 예시 borough 필드 값이 "Bronx" 이고 cuisine 필드 값이 "Pizza"인 모든 문서에 대해 name 필드 의 고유 값을 검색합니다. 그런 다음 Distinct() 메서드에 DistinctOptions 인스턴스 제공하여 작업에 주석을 추가합니다.

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

var cuisineFilter = Builders<Restaurant>.Filter.Eq(r => r.Cuisine, "Pizza");
var boroughFilter = Builders<Restaurant>.Filter.Eq(r => r.Borough, "Bronx");
var filter = Builders<Restaurant>.Filter.And(cuisineFilter, boroughFilter);
var options = new DistinctOptions {
    Comment = "Find all Italian restaurants in the Bronx"
};
var results = collection.Distinct<string>(r => r.Name, filter).ToList();
foreach (var result in results)
{
    Console.WriteLine(result);
}

$1.25 Pizza
18 East Gunhill Pizza
2 Bros
Aenos Pizza
Alitalia Pizza Restaurant
Amici Pizza And Pasta
Angie'S Cafe Pizza
...

var cuisineFilter = Builders<Restaurant>.Filter.Eq(r => r.Cuisine, "Pizza");
var boroughFilter = Builders<Restaurant>.Filter.Eq(r => r.Borough, "Bronx");
var filter = Builders<Restaurant>.Filter.And(cuisineFilter, boroughFilter);
var options = new DistinctOptions {
    Comment = "Find all Italian restaurants in the Bronx"
};
var results = await collection.DistinctAsync<string>(r => r.Name, filter, options);
await results.ForEachAsync(result => Console.WriteLine(result));

$1.25 Pizza
18 East Gunhill Pizza
2 Bros
Aenos Pizza
Alitalia Pizza Restaurant
Amici Pizza And Pasta
Angie'S Cafe Pizza
...

데이터 정렬

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

다음 표에서는 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`	(선택 사항) 3차 수준 비교 시 대소문자 차이의 정렬 순서를 지정합니다. 데이터 유형: CollationCaseFirst 기본값: `CollationCaseFirst.Off`	`CaseFirst`
`strength`	(선택 사항) ICU 문서에 정의된 대로 수행할 비교 수준을 지정합니다. 데이터 유형: CollationStrength 기본값: `CollationStrength.Tertiary`	`Strength`
`numericOrdering`	(Optional) Specifies whether the driver compares numeric strings as numbers. If this argument is `true`, the driver compares numeric strings as numbers. For example, when comparing the strings "10" and "2", the driver treats the values as 10 and 2, and finds 10 to be greater. If this argument is `false` or excluded, the driver compares numeric strings as strings. For example, when comparing the strings "10" and "2", the driver compares one character at a time. Because "1" is less than "2", the driver finds "10" to be less than "2". For more information, see Collation Restrictions in the MongoDB Server manual. Data Type: `boolean` Default: `false`	`NumericOrdering`
`alternate`	(선택 사항) 비교를 위해 드라이버가 공백과 구두점을 기본 문자로 간주할지 여부를 지정합니다. 데이터 유형: CollationAlternate 기본값: `CollationAlternate.NonIgnorable` (공백과 구두점은 기본 문자로 간주됨)	`Alternate`
`maxVariable`	(선택 사항) `alternate`이(가) `CollationAlternate.Shifted`일 때 드라이버가 무시할 수 있는 것으로 간주하는 문자를 지정합니다. 데이터 유형: CollationMaxVariable 기본값: `CollationMaxVariable.Punctuation` (드라이버가 문장 부호와 공백을 무시함)	`MaxVariable`
`normalization`	(선택 사항) 드라이버가 필요에 따라 텍스트를 정규화할지 여부를 지정합니다. 대부분의 텍스트는 정규화가 필요하지 않습니다. 정규화에 대한 자세한 내용은 ICU 설명서를 참조하세요. 데이터 유형: `boolean` 기본값: `false`	`Normalization`
`backwards`	(선택 사항) 분음 부호가 포함된 string이 string의 뒤쪽에서 앞쪽으로 정렬되는지 지정합니다. 데이터 유형: `boolean` 기본값: `false`	`Backwards`

For more information about collation, see the Collation page in the MongoDB Server manual.

API 문서

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

돌아가기

문서 수 계산

커서에서 데이터 액세스