Retrieve Data

샘플 데이터

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

auto db = client["sample_training"];
auto collection = db["companies"];

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

하나의 문서 찾기

컬렉션 에서 단일 문서 를 찾으려면 find_one() 메서드를 호출하고 찾으려는 문서 의 기준을 지정하는 쿼리 필터하다 를 전달합니다.

find_one() 메서드는 std::optional< bsoncxx::document::value > 의 인스턴스 를 반환합니다. 쿼리 필터하다 가 문서 와 일치하는 경우 optional 객체 에는 bsoncxx::document::value 유형의 값이 포함됩니다. 쿼리 필터하다 가 어떤 문서와도 일치하지 않으면 optional 객체 에 값이 포함되지 않습니다.

쿼리 필터하다 가 둘 이상의 문서 와 일치하는 경우 find_one() 메서드는 조회된 결과에서 첫 번째 로 일치하는 문서 를 반환합니다.

다음 예시 에서는 find_one() 메서드를 사용하여 name 필드 의 값이 "LinkedIn" 인 첫 번째 문서 를 찾습니다.

auto result = collection.find_one(make_document(kvp("name", "LinkedIn")));
std::cout << bsoncxx::to_json(*result) << std::endl;

{ "_id" : { "$oid" : "52cdef7c4bab8bd675297e0c" }, "name" : "LinkedIn", "permalink" : "linkedin",
"crunchbase_url" : "http://www.crunchbase.com/company/linkedin", "homepage_url" : "http://linkedin.com",
...

정렬에 학습 보려면 반환할 문서 지정 가이드 의 정렬 섹션을 참조하세요.

여러 문서 찾기

컬렉션에서 여러 문서를 찾으려면 검색하려는 문서의 기준을 지정하는 find() 메서드에 쿼리 필터를 전달합니다.

다음 예시 에서는 find() 메서드를 사용하여 founded_year 필드 에 1970 값이 있는 모든 문서를 찾습니다.

auto cursor = collection.find(make_document(kvp("founded_year", 1970)));

find() 메서드는 mongocxx::cursor 인스턴스 를 반환하며, 이를 반복하여 일치하는 문서를 볼 수 있습니다. 커서 는 애플리케이션 이 주어진 시간에 데이터베이스 결과의 하위 집합만 메모리에 유지하면서 데이터베이스 결과를 반복할 수 있는 메커니즘입니다. 커서는 find() 메서드가 많은 양의 문서를 반환할 때 유용합니다.

다음 예제와 같이 for-in 루프를 사용하여 커서에 있는 문서를 반복할 수 있습니다.

auto cursor = collection.find(make_document(kvp("founded_year", 1970)));
for(auto&& doc : cursor) {
    std::cout << bsoncxx::to_json(doc) << std::endl;
}

{ "_id" : { "$oid" : "52cdef7d4bab8bd675298be4" }, "name" : "Mitsubishi Motors",
"permalink" : "mitsubishi-motors", "crunchbase_url" : "http://www.crunchbase.com/company/mitsubishi-motors",
...
{ "_id" : { "$oid" : "52cdef7e4bab8bd67529b996" }, "name" : "Western Digital",
"permalink" : "western-digital", "crunchbase_url" : "http://www.crunchbase.com/company/western-digital",
...
{ "_id" : { "$oid" : "52cdef7e4bab8bd67529b9f1" }, "name" : "Celarayn", "permalink" : "celarayn",
"crunchbase_url" : "http://www.crunchbase.com/company/celarayn",
...

auto cursor = collection.find({})

검색 동작 수정

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

다음 예시 에서는 find() 메서드를 사용하여 number_of_employees 필드 의 값이 1000 인 모든 문서를 찾고 최대 5 결과를 반환하도록 작업에 지시합니다.

mongocxx::options::find opts;
opts.limit(5);
auto cursor = collection.find(make_document(kvp("number_of_employees", 1000)), opts);

mongocxx::options::find 객체 필드의 전체 목록은 API 설명서를 참조하세요.

API 문서

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

• find()

• find_one()

• limit()