고유 필드 값 검색

이 페이지의 내용

개요

샘플 데이터
고유 명령
컬렉션 전체에서 고유 값 검색
지정된 문서에서 고유 값 검색
고유 동작 수정
추가 정보
API 문서

개요

이 가이드 에서는 C 운전자 를 사용하여 컬렉션 전체에서 지정된 필드 의 고유 값을 조회 하는 방법을 학습 수 있습니다.

컬렉션 내에서 서로 다른 문서에 단일 필드 에 대해 서로 다른 값이 포함될 수 있습니다. 예를 예시 restaurant 컬렉션 의 한 문서 는 borough 값이 "Manhattan"이고 다른 문서의 borough 값은 "Queens"입니다. C 운전자 를 사용하면 컬렉션 의 여러 문서에서 필드 에 포함된 고유 값을 모두 조회 할 수 있습니다.

샘플 데이터

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

고유 명령

지정된 필드 의 고유 값을 조회 하려면 mongoc_collection_read_command_with_opts() 함수를 호출하고 distinct 명령을 사용하도록 지시합니다. 또한 데이터를 조회 할 컬렉션 과 필드 를 지정해야 합니다.

컬렉션 전체에서 고유 값 검색

다음 예에서는 restaurants 컬렉션에 있는 borough 필드의 고유 값을 검색합니다.

bson_t reply;
bson_error_t error;
bson_t *command = BCON_NEW ("distinct",
                    BCON_UTF8 ("restaurants"),
                    "key",
                    BCON_UTF8 ("borough"));
if (!mongoc_collection_read_command_with_opts (collection, command, NULL, NULL, &reply, &error)) {
    fprintf (stderr, "An error occurred: %s\n", error.message);
} else {
    char *str = bson_as_canonical_extended_json (&reply, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
bson_destroy (&reply);
bson_destroy (command);

{ "values" : [ "Bronx", "Brooklyn", "Manhattan", "Missing", "Queens", "Staten Island" ], ... }

결과에는 컬렉션의 모든 문서에서 borough 필드에 나타나는 모든 고유 값이 표시됩니다. 여러 문서의 borough 필드에 동일한 값이 있지만 각 값은 결과에 한 번만 표시됩니다.

지정된 문서에서 고유 값 검색

명령에 쿼리 필터하다 를 제공하여 컬렉션 의 distinct 문서 하위 집합에서 고유 필드 값을 찾을 수 있습니다. 쿼리 필터하다 는 작업에서 문서를 일치시키는 데 사용되는 검색 기준을 지정하는 표현식 입니다.

쿼리 필터 만들기에 학습 보려면 쿼리 지정을 참조하세요.

다음 예에서는 cuisine 필드 값이 "Italian" 인 모든 문서에 대해 borough 필드의 고유 값을 검색합니다.

bson_t reply;
bson_error_t error;
bson_t *query = BCON_NEW ("cuisine", BCON_UTF8 ("Italian"));
bson_t *command = BCON_NEW ("distinct", BCON_UTF8 ("restaurants"),
                    "key", BCON_UTF8 ("borough"),
                    "query", BCON_DOCUMENT (query));
if (!mongoc_collection_read_command_with_opts (collection, command, NULL, NULL, &reply, &error)) {
    fprintf (stderr, "An error occurred: %s\n", error.message);
} else {
    char *str = bson_as_canonical_extended_json (&reply, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
bson_destroy (&reply);
bson_destroy (command);
bson_destroy (query);

{ "values" : [ "Bronx", "Brooklyn", "Manhattan", "Queens", "Staten Island" ], ... }

고유 동작 수정

distinct 명령은 mongoc_collection_read_command_with_opts() 함수에 옵션을 전달하여 수정할 수 있습니다. 옵션을 지정하지 않으면 운전자 는 작업을 사용자 지정하지 않습니다.

다음 표에서는 distinct 작업을 사용자 지정하는 데 사용할 수 있는 몇 가지 옵션을 설명합니다.

옵션	설명
`collation`	Specifies the kind of language collation to use when sorting results. For more information, see Collation in the MongoDB Server manual.
`comment`	Specifies a comment to attach to the operation.

작업을 수정하는 데 사용할 distinct 수 있는 옵션의 전체 목록은 MongoDB Server 매뉴얼의 고유 문서를 참조하세요.

다음 예시에서는 borough 필드 값이 "Bronx" 이고 cuisine 필드 값이 "Pizza" 인 모든 문서에 대해 name 필드의 고유 값을 검색합니다. 또한 comment 옵션을 사용하여 작업에 주석을 추가합니다.

bson_t reply;
bson_error_t error;
bson_t *query = BCON_NEW ("borough", BCON_UTF8 ("Bronx"),
                          "cuisine", BCON_UTF8 ("Pizza"));
bson_t *command = BCON_NEW ("distinct", BCON_UTF8 ("restaurants"),
                    "key", BCON_UTF8 ("name"),
                    "query", BCON_DOCUMENT (query));
bson_t *opts = BCON_NEW ("comment", BCON_UTF8 ("Bronx pizza restaurants"));
if (!mongoc_collection_read_command_with_opts (collection, command, NULL, opts, &reply, &error)) {
    fprintf (stderr, "An error occurred: %s\n", error.message);
} else {
    char *str = bson_as_canonical_extended_json (&reply, NULL);
    printf ("%s\n", str);
    bson_free (str);
}
bson_destroy (&reply);
bson_destroy (command);
bson_destroy (query);
bson_destroy (opts);

{ "values" : [ "$1.25 Pizza", "18 East Gunhill Pizza", "2 Bros", "Aenos Pizza", "Alitalia Pizza Restaurant", ... ], ... }

추가 정보

distinct 명령에 학습 보려면 MongoDB Server 매뉴얼의 Distinct 페이지를 참조하세요.

API 문서

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

돌아가기

문서 수 계산

커서에서 데이터 액세스