반환할 필드 지정

이 페이지의 내용

개요

샘플 데이터
프로젝션 유형
포함할 필드 지정
_id 필드 제외
추가 정보
API 문서

개요

이 가이드에서는 프로젝션 을 사용하여 읽기 작업에서 반환할 필드를 지정하는 방법을 배울 수 있습니다. 프로젝션은 MongoDB가 쿼리에서 반환하는 필드를 지정하는 문서입니다.

샘플 데이터

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

프로젝션 유형

프로젝션 을 사용하여 반환 문서 에 포함할 필드를 지정하거나 제외할 필드를 지정할 수 있습니다.

프로젝션 에 포함할 특정 필드를 지정할 때 다른 모든 필드는 암시적으로 제외됩니다( 기본값 포함되는 _id 필드 제외). _id 필드 를 제외하지 않는 한 단일 프로젝션 에서 포함 및 제외 문을 결합할 수 없습니다.

반환 문서 에서 _id 필드 를 제거 하려면 해당 필드를 명시적으로 제외해야 합니다.

포함할 필드 지정

다음 예시 에서는 mongoc_collection_find_with_opts() 함수를 사용하여 name 필드 값이 "Emerald Pub" 인 모든 레스토랑을 찾습니다. mongoc_collection_find_with_opts() 의 옵션 매개 변수를 사용하여 반환된 문서의 name, cuisine 및 borough 필드만 반환하도록 프로젝션 을 지정합니다.

const bson_t *doc;
bson_t *filter = BCON_NEW ("name", BCON_UTF8 ("Emerald Pub"));
bson_t *opts = BCON_NEW ("projection", "{",
                    "name", BCON_BOOL (true),
                    "cuisine", BCON_BOOL (true),
                    "borough", BCON_BOOL (true),
                    "}");
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" : "..." }, "borough" : "Manhattan", "cuisine" : "American", "name" : "Emerald Pub" }
{ "_id" : { "$oid" : "..." }, "borough" : "Queens", "cuisine" : "American", "name" : "Emerald Pub" }

필드 제외 `_id`

포함할 필드를 지정할 때 반환된 문서에서 _id 필드를 제외할 수도 있습니다.

다음 예시 에서는 앞의 예시 와 동일한 쿼리 를 실행하지만 프로젝션 에서 _id 필드 를 제외합니다.

const bson_t *doc;
bson_t *filter = BCON_NEW ("name", BCON_UTF8 ("Emerald Pub"));
bson_t *opts = BCON_NEW ("projection", "{",
                    "name", BCON_BOOL (true),
                    "cuisine", BCON_BOOL (true),
                    "borough", BCON_BOOL (true),
                    "_id", BCON_BOOL (false),
                    "}");
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);

{ "borough" : "Manhattan", "cuisine" : "American", "name" : "Emerald Pub" }
{ "borough" : "Queens", "cuisine" : "American", "name" : "Emerald Pub" }

추가 정보

프로젝션에 대해 자세히 알아보려면 MongoDB Server 매뉴얼의 프로젝트 필드 가이드 를 참조하세요.

API 문서

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

mongoc_collection_find_with_opts()

돌아가기

Retrieve Data

반환할 문서 지정

개요