고유 필드 값 검색

이 페이지의 내용

개요

샘플 데이터
Retrieve Distinct Values
컬렉션 전체에서 값 검색
지정된 문서에서 값 검색
고유 동작 수정
API 문서

개요

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

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

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants.restaurants 컬렉션 을 사용합니다. 무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 빠른 시작을 참조하세요.

이 페이지의 예제에서는 다음 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 필드 의 고유 값을 검색합니다. Asynchronous 또는 Synchronous 탭 을 선택하여 해당 코드를 확인합니다.

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

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

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

지정된 문서에서 값 검색

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

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

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

Bronx
Brooklyn
Manhattan
Queens
Staten Island

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

Bronx
Brooklyn
Manhattan
Queens
Staten Island

고유 동작 수정

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

메서드	설명
`Collation`	Sets the collation to use for the operation. Data type: Collation
`MaxTime`	Sets the maximum amount of time that the operation can run. Data type: `TimeSpan`
`Comment`	Attaches a comment to the operation. Data type: BsonValue or `string`

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

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

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
...

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
...

API 문서

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

돌아가기

문서 수 계산

데이터 변경 사항 모니터링