반환할 문서 지정

이 페이지의 내용

개요

샘플 데이터
Limit
Sort
Skip
제한, 정렬 및 건너뛰기 결합
추가 정보
API 문서

개요

이 가이드 에서는 다음 작업을 사용하여 읽기 작업에서 반환할 문서를 지정하는 방법을 학습 수 있습니다.

limit: 쿼리 에서 반환할 최대 문서 수를 지정합니다.
sort: 반환된 문서의 정렬 순서를 지정합니다.
skip: 쿼리 결과를 반환하기 전에 건너뛸 문서 수를 지정합니다.

샘플 데이터

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

Limit

읽기 작업에서 반환되는 최대 문서 수를 지정하려면 limit 옵션을 mongoc_collection_find_with_opts() 함수 호출에 전달합니다.

다음 예시 에서는 cuisine 필드 값이 "Italian" 인 모든 레스토랑을 찾고 결과를 5 문서로 제한합니다.

const bson_t *doc;
bson_t *filter = BCON_NEW ("cuisine", BCON_UTF8 ("Italian"));
bson_t *opts = BCON_NEW ("limit", BCON_INT64 (5));
mongoc_cursor_t *results =
    mongoc_collection_find_with_opts (collection, filter, opts, NULL);
while (mongoc_cursor_next (results, &doc)) {
    char *str = bson_as_canonical_extended_json (doc, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
bson_destroy (filter);
bson_destroy (opts);
mongoc_cursor_destroy (results);

{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "V & T Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Mimis Restaurant & Bar", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Venice Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Areo Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Tre Giovani Pizza & Pasta", ... }

팁

앞의 예시 에서는 쿼리 에서 반환된 처음 5개의 문서를 기본 기본 순서 반환합니다. 다음 섹션에서는 지정된 정렬 순서로 문서를 반환하는 방법에 대해 설명합니다.

Sort

지정된 순서로 문서를 반환하려면 sort 옵션을 사용합니다. sort 옵션은 정렬 방향을 매개 변수로 사용합니다. 정렬 방향을 지정하려면 오름차순 정렬의 경우 1 를 전달하고 내림차순 정렬의 경우 -1 을 전달합니다. 오름차순은 가장 낮은 값에서 가장 높은 값으로 정렬하고 내림차순은 가장 높은 값에서 가장 낮은 값으로 정렬합니다.

다음 예시 에서는 cuisine 필드 값이 "Italian" 인 모든 문서를 name 필드 값을 기준으로 오름차순으로 정렬하여 반환합니다.

const bson_t *doc;
bson_t *filter = BCON_NEW ("cuisine", BCON_UTF8 ("Italian"));
bson_t *opts = BCON_NEW ("sort", "{", "name", BCON_INT32 (1), "}");
mongoc_cursor_t *results =
    mongoc_collection_find_with_opts (collection, filter, opts, NULL);
while (mongoc_cursor_next (results, &doc)) {
    char *str = bson_as_canonical_extended_json (doc, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
bson_destroy (filter);
bson_destroy (opts);
mongoc_cursor_destroy (results);

{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "(Lewis Drug Store) Locanda Vini E Olii", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "101 Restaurant And Bar", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "44 Sw Ristorante & Bar", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "900 Park", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "A Voce", ... }
...

Skip

쿼리 결과를 반환하기 전에 지정된 수의 문서를 건너뛰려면 skip 옵션을 사용하고 건너뛸 문서 수를 전달합니다. skip 옵션은 쿼리 결과에서 지정된 수의 문서를 무시하고 나머지를 반환합니다.

다음 예시 에서는 cuisine 필드 값이 "Italian" 인 모든 문서를 반환하고 처음 10 문서를 건너뜁니다.

const bson_t *doc;
bson_t *filter = BCON_NEW ("cuisine", BCON_UTF8 ("Italian"));
bson_t *opts = BCON_NEW ("skip", BCON_INT64 (10));
mongoc_cursor_t *results =
    mongoc_collection_find_with_opts (collection, filter, opts, NULL);
while (mongoc_cursor_next (results, &doc)) {
    char *str = bson_as_canonical_extended_json (doc, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
bson_destroy (filter);
bson_destroy (opts);
mongoc_cursor_destroy (results);

{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Trattoria Alba", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Da Umberto Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "La Strada Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Pasta Lovers Trattoria", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Nanni Restaurant", ... }
...

제한, 정렬 및 건너뛰기 결합

단일 작업으로 limit, sort 및 skip 옵션을 결합할 수 있습니다. 이렇게 하면 지정된 수의 문서를 건너뛰고 반환할 정렬된 최대 문서 수를 설정하다 수 있습니다.

다음 예시 에서는 cuisine 필드 값이 "Italian" 인 문서를 반환합니다. 결과는 알파벳순으로 정렬되며 처음 10 문서는 건너뛰고 결과는 5 문서로 제한됩니다.

const bson_t *doc;
bson_t *filter = BCON_NEW ("cuisine", BCON_UTF8 ("Italian"));
bson_t *opts = BCON_NEW ("limit", BCON_INT64 (5),
                        "skip", BCON_INT64 (10), 
                        "sort", "{", "name", BCON_INT32 (1), "}");
                        
mongoc_cursor_t *results =
    mongoc_collection_find_with_opts (collection, filter, opts, NULL);
while (mongoc_cursor_next (results, &doc)) {
    char *str = bson_as_canonical_extended_json (doc, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
bson_destroy (filter);
bson_destroy (opts);
mongoc_cursor_destroy (results);

{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Acqua", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Acqua Restaurant", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Acqua Santa", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Acquista Trattoria", ... }
{ "_id" : { "$oid" : "..." }, "cuisine" : "Italian", "name" : "Acquolina Catering", ... }

참고

이러한 메서드를 호출하는 순서는 반환되는 문서를 변경하지 않습니다. 운전자 는 호출을 자동으로 재정렬하여 정렬 및 건너뛰기 작업을 먼저 수행하고 제한 작업을 나중에 수행합니다.

추가 정보

쿼리 지정에 대한 자세한 내용은 쿼리 지정을 참조하세요.

문서 조회에 대한 자세한 내용은 데이터 조회를 참조하세요.

API 문서

mongoc_collection_find_with_opts() 함수에 학습 보려면 API 설명서를 참조하세요.

돌아가기

반환할 필드 지정

문서 수 계산