Retrieve Data

샘플 데이터

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

문서 찾기 예시

다음 예시 에서는 mongoc_collection_find_with_opts() 함수를 사용하여 cuisine 필드 의 값이 "Spanish"인 모든 문서를 찾습니다.

bson_t *filter = BCON_NEW ("cuisine", BCON_UTF8 ("Spanish"));
mongoc_cursor_t *results = 
    mongoc_collection_find_with_opts (collection, filter, NULL, NULL);

앞의 예시 에서 mongoc_collection_find_with_opts() 연산은 mongoc_cursor_t * 을 반환하며, 이는 mongoc_cursor_next() 함수와 동안 루프를 사용하여 반복할 수 있습니다. 다음 예시 에서는 반복하여 이전 쿼리 에서 반환된 결과를 출력합니다.

const bson_t *doc;
bson_error_t error;
while (mongoc_cursor_next (results, &doc)) {
    char *str = bson_as_canonical_extended_json (doc, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
// Ensure we iterated through cursor without error
if (mongoc_cursor_error (results, &error)) {
    fprintf (stderr, "Error getting results: %s\n", error.message);
}
mongoc_cursor_destroy (results);
bson_destroy (filter);

{ "_id" : { "$oid" : "..." }, "name" : "Charle'S Corner Restaurant & Deli", "cuisine" : "Spanish", ... }
{ "_id" : { "$oid" : "..." }, "name" : "Real Madrid Restaurant", "cuisine" : "Spanish", ... }
{ "_id" : { "$oid" : "..." }, "name" : "Malaga Restaurant", "cuisine" : "Spanish", ... }
{ "_id" : { "$oid" : "..." }, "name" : "Cafe Espanol", "cuisine" : "Spanish", ... }
{ "_id" : { "$oid" : "..." }, "name" : "Cafe Riazor", "cuisine" : "Spanish", ... }
...

bson_t *empty_filter = bson_new ();
mongoc_cursor_t *results = 
    mongoc_collection_find_with_opts (collection, empty_filter, NULL, NULL);
mongoc_cursor_destroy (results);
bson_destroy (empty_filter);

검색 동작 수정

구성하려는 옵션이 포함된 bson_t 구조를 전달하여 mongoc_collection_find_with_opts() 함수의 동작을 수정할 수 있습니다. 다음 표에서는 쿼리 수정에 일반적으로 사용되는 옵션에 대해 설명합니다.

다음 예시 에서는 limit 및 maxTimeMS 옵션을 사용하여 쿼리 에서 반환되는 문서 수를 10 로 제한하고 작업의 최대 실행 시간을 10000 밀리초로 설정하다 합니다.

bson_t *filter = BCON_NEW ("cuisine", BCON_UTF8 ("Spanish"));
bson_t *opts = BCON_NEW ("limit", BCON_INT32 (10), "maxTimeMS", BCON_INT32 (10000));
mongoc_cursor_t *results = 
    mongoc_collection_find_with_opts (collection, filter, opts, NULL);
mongoc_cursor_destroy (results);
bson_destroy (filter);
bson_destroy (opts);

의 동작을 수정하는 옵션의 mongoc_collection_find_with_opts() 전체 목록은 MongoDB Server 매뉴얼의 find 메서드 설명서를 참조하세요.

API 문서

이 가이드 에서 설명하는 함수에 학습 보려면 다음 API 문서를 참조하세요.

• mongoc_collection_find_with_opts()