고유 필드 값 검색
개요
이 가이드 에서는 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 설명서를 참조하세요.