문서 수 계산

이 페이지의 내용

개요

샘플 데이터
정확한 개수 조회
모든 문서 계산
특정 문서 수 계산
카운트 동작 사용자 지정
예상 개수 조회
예상 카운트 동작 사용자 지정
API 문서

개요

이 가이드 에서는 컬렉션 에 있는 문서 수의 정확한 개수와 예상 개수를 조회 하는 방법에 학습 수 있습니다.

샘플 데이터

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

정확한 개수 조회

컬렉션 에 있는 문서 수를 계산하려면 mongoc_collection_count_documents() 함수를 사용합니다. 지정된 검색 기준과 일치하는 문서 수를 계산하려면 mongoc_collection_count_documents() 함수에 쿼리 필터하다 를 전달합니다.

쿼리 지정에 학습 보려면 쿼리 지정을 참조하세요.

모든 문서 계산

컬렉션 에 있는 모든 문서의 개수를 반환하려면 다음 예시 와 같이 빈 쿼리 필터하다 를 사용하여 mongoc_collection_count_documents() 함수를 호출합니다.

bson_error_t error;
bson_t *empty_query = bson_new ();
int64_t count = 
    mongoc_collection_count_documents (collection, empty_query, NULL, NULL, NULL, &error);
printf ("%" PRId64 "\n", count);
bson_destroy (empty_query);

특정 문서 수 계산

특정 검색 기준과 일치하는 문서 수를 반환하려면 mongoc_collection_count_documents() 함수에 쿼리 를 지정합니다. 다음 예시 에서는 movies 컬렉션 에서 year 필드 값이 1930 인 모든 문서의 개수를 출력합니다.

bson_error_t error;
bson_t *query = BCON_NEW ("year", BCON_INT32 (1930));
int64_t count =
    mongoc_collection_count_documents (collection, query, NULL, NULL, NULL, &error);
printf ("%" PRId64 "\n", count);
bson_destroy (query);

카운트 동작 사용자 지정

mongoc_collection_count_documents() 함수는 카운트 작업을 구성하는 데 사용할 수 있는 옵션 설정하다 를 나타내는 bson_t 구조 형식의 선택적 매개변수를 허용합니다. 옵션을 지정하지 않으면 운전자 는 카운트 작업을 사용자 지정하지 않습니다.

다음 표에서는 countDocuments() 을(를) 사용자 지정하기 위해 설정할 수 있는 옵션에 대해 설명합니다.

옵션	설명
`comment`	Specifies a comment to attach to the operation.
`skip`	Sets the number of documents to skip before returning results.
`limit`	Sets the maximum number of documents to count. Must be a positive integer.
`collation`	Specifies the kind of language collation to use when sorting results. For more information, see Collation in the MongoDB Server manual.
`hint`	Sets the index to scan for documents.

전체 옵션 목록은 에 대한 API 설명서 를 mongoc_collection_count_documents()참조하세요.

다음 예시 에서는 bson_t 구조를 사용하여 mongoc_collection_count_documents() 작업에 주석을 추가합니다.

bson_error_t error;
bson_t *opts = BCON_NEW ("comment", BCON_UTF8 ("Retrieving count"));
int64_t count =
    mongoc_collection_count_documents (collection, bson_new (), opts, NULL, NULL, &error);
printf ("%" PRId64 "\n", count);
bson_destroy (opts);

예상 개수 조회

컬렉션 에 있는 문서 수의 추정치를 조회 하려면 mongoc_collection_estimated_document_count() 함수를 사용합니다. 이 함수는 컬렉션 메타데이터 를 기반으로 문서의 양을 추정하며, 이는 정확한 개수를 계산하는 것보다 빠를 수 있습니다.

다음 예시 에서는 컬렉션 의 예상 문서 수를 출력합니다.

bson_error_t error;
int64_t count =
    mongoc_collection_estimated_document_count (collection, NULL, NULL, NULL, &error);
printf ("%" PRId64 "\n", count);

예상 카운트 동작 사용자 지정

mongoc_collection_estimated_document_count() 함수는 카운트 작업을 구성하는 데 사용할 수 있는 옵션을 나타내는 bson_t 구조 형식의 선택적 매개변수를 허용합니다. 옵션을 지정하지 않으면 운전자 는 카운트 작업을 사용자 지정하지 않습니다.

다음 표에서는 mongoc_collection_estimated_document_count() 을(를) 사용자 지정하기 위해 설정할 수 있는 옵션에 대해 설명합니다.

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

전체 옵션 목록은 에 대한 API 설명서를 mongoc_collection_estimated_document_count()참조하세요.

다음 예시 에서는 bson_t 구조를 사용하여 mongoc_collection_estimated_document_count() 작업에 주석을 추가합니다.

bson_error_t error;
bson_t *opts = BCON_NEW ("comment", BCON_UTF8 ("Retrieving count"));
int64_t count =
    mongoc_collection_estimated_document_count (collection, opts, NULL, NULL, &error);
printf ("%" PRId64 "\n", count);
bson_destroy (opts);

API 문서

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

돌아가기

반환할 문서 지정

고유 필드 값