고유 필드 값 검색

이 페이지의 내용

개요

샘플 데이터
distinct() 메서드
컬렉션 전체에서 고유 값 검색
지정된 문서에서 고유 값 검색
고유 동작 수정
API 문서

개요

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

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

샘플 데이터

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_restaurants 데이터베이스 에 있는 restaurants 컬렉션 을 사용합니다. C++ 애플리케이션 에서 이 컬렉션 에 액세스 하려면 Atlas cluster 에 연결하는 mongocxx::client 를 인스턴스화하고 db 및 collection 변수에 다음 값을 할당합니다.

auto db = client["sample_restaurants"];
auto collection = db["restaurants"];

무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 Atlas 시작하기 가이드 를 참조하세요.

`distinct()` 메서드

지정된 필드의 고유 값을 검색하려면 distinct() 메서드를 호출하고 고유 값을 찾으려는 필드의 이름을 전달합니다.

컬렉션 전체에서 고유 값 검색

다음 예에서는 restaurants 컬렉션에 있는 borough 필드의 고유 값을 검색합니다.

auto cursor = collection.distinct("borough", {});
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "values" : [ "Bronx", "Brooklyn", "Manhattan", "Missing", "Queens", "Staten Island" ],
"ok" : 1.0, "$clusterTime" : { "clusterTime" : { "$timestamp" : { ... } },
"signature" : { "hash" : { ... }, "keyId" : ... } }, "operationTime" : { "$timestamp" : { ... } }

이 작업은 단일 문서 를 포함하는 커서 를 반환합니다. 이 문서 에는 고유한 borough 필드 값 목록과 작업에 대한 메타데이터 가 포함되어 있습니다. 여러 문서의 borough 필드 에 동일한 값이 있더라도 각 값은 결과에 한 번만 표시됩니다.

지정된 문서에서 고유 값 검색

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

다음 예에서는 cuisine 필드 값이 "Italian" 인 모든 문서에 대해 borough 필드의 고유 값을 검색합니다.

auto cursor = collection.distinct("borough", make_document(kvp("cuisine", "Italian")));
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "values" : [ "Bronx", "Brooklyn", "Manhattan", "Queens", "Staten Island" ],
"ok" : 1.0, "$clusterTime" : { "clusterTime" : { "$timestamp" : { ... },
"signature" : { "hash" : { ... }, "keyId" : ... } }, "operationTime" : { "$timestamp" : { ... } }

고유 동작 수정

mongocxx::options::distinct 클래스의 인스턴스 를 인수로 전달하여 distinct() 메서드의 동작을 수정할 수 있습니다. 다음 표에서는 mongocxx::options::distinct 인스턴스 에서 설정하다 수 있는 필드에 대해 설명합니다.

필드	설명
`collation`	The collation to use for the operation. Type: `bsoncxx::document::view_or_value`
`max_time`	The maximum amount of time in milliseconds that the operation can run. Type: `std::chrono::milliseconds`
`comment`	The comment to attach to the operation. Type: `bsoncxx::types::bson_value::view_or_value`
`read_preference`	The read preference to use for the operation. Type: `mongocxx::read_preference`

다음 예시 에서는 borough 필드 값이 "Bronx" 이고 cuisine 필드 값이 "Pizza" 인 모든 문서에 대해 name 필드 의 고유 값을 검색합니다. 또한 옵션 인스턴스 의 comment 필드 를 지정하여 작업에 주석을 추가합니다.

mongocxx::options::distinct opts{};
opts.comment(bsoncxx::types::bson_value::view_or_value{"Bronx pizza restaurants"});
auto cursor = collection.distinct("name",
    make_document(kvp("$and",
                        make_array(make_document(kvp("borough", "Bronx")),
                                    make_document(kvp("cuisine", "Pizza"))))),
    opts
);
for (auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "values" : [ "$1.25 Pizza", "18 East Gunhill Pizza", "2 Bros", "Aenos Pizza", "Alitalia Pizza Restaurant", … ],
  "ok" : 1.0, "$clusterTime" : { "clusterTime" : { … }, "signature" : { … }, "keyId" : … } }, "operationTime" : { … } }

API 문서

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

돌아가기

반환할 필드 지정

문서 수 계산

개요