Docs Menu

문서 수 계산

이 가이드 에서는 MongoDB PHP 라이브러리를 사용하여 컬렉션 에 있는 문서 수의 정확한 예상 개수를 조회 하는 방법을 학습 수 있습니다. 다음 메서드는 컬렉션 의 문서 수를 계산합니다.

  • MongoDB\Collection::countDocuments(): 쿼리 필터하다 와 일치하거나 컬렉션 에 존재하는 문서의 정확한 수를 반환합니다.

  • MongoDB\Collection::estimatedDocumentCount(): 컬렉션 의 예상 문서 수를 반환합니다.

이 가이드 의 예제에서는 Atlas 샘플 데이터 세트sample_training 데이터베이스 에 있는 companies 컬렉션 을 사용합니다. PHP 애플리케이션 에서 이 컬렉션 에 액세스 하려면 Atlas cluster 에 연결하는 MongoDB\Client 를 인스턴스화하고 $collection 변수에 다음 값을 할당합니다.

$collection = $client->sample_training->companies;

무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 Atlas 시작하기 가이드 를 참조하세요.

컬렉션 의 문서 수를 계산하려면 MongoDB\Collection::countDocuments() 메서드를 사용합니다. 특정 검색 기준과 일치하는 문서 수를 계산하려면 countDocuments() 메서드에 쿼리 필터하다 를 전달합니다.

쿼리 지정에 대해 자세히 알아보려면 쿼리 지정 가이드를 참조하세요.

컬렉션 의 모든 문서 수를 반환하려면 다음 예시 와 같이 빈 쿼리 필터하다 배열 을 countDocuments() 메서드에 전달합니다.

$result = $collection->countDocuments([]);
echo 'Number of documents: ', $result;
Number of documents: 9500

특정 검색 기준과 일치하는 문서 수를 반환하려면 countDocuments() 메서드에 쿼리 필터하다 를 전달합니다.

다음 예시 에서는 founded_year 필드 의 값이 2010 인 문서 수를 계산합니다.

$result = $collection->countDocuments(['founded_year' => 2010]);
echo 'Number of companies founded in 2010: ', $result;
Number of companies founded in 2010: 33

옵션 값을 지정하는 배열 을 전달하여 countDocuments() 메서드의 동작을 수정할 수 있습니다. 다음 표에서는 카운트 작업을 사용자 지정하기 위해 설정하다 수 있는 몇 가지 옵션을 설명합니다.

옵션
설명

collation

The collation to use for the operation.
Type: array|object

hint

The index to use for the operation.
Type: string|array|object

comment

The comment to attach to the operation.
Type: any valid BSON type

limit

The maximum number of documents to count. This value must be a positive integer.
Type: integer

maxTimeMS

The maximum amount of time in milliseconds that the operation can run.
Type: integer

skip

The number of documents to skip before counting documents.
Type: integer

readPreference

The read preference to use for the operation. To learn more, see Read Preference in the Server manual.
Type: MongoDB\Driver\ReadPreference

다음 예시 에서는 countDocuments() 메서드를 사용하여 number_of_employees 필드 의 값이 50 인 문서 수를 계산하고 최대 100 결과를 계산하도록 작업에 지시합니다.

$result = $collection->countDocuments(
['number_of_employees' => 50],
['limit' => 100]
);
echo 'Number of companies with 50 employees: ', $result;
Number of companies with 50 employees: 100

MongoDB\Collection::estimatedDocumentCount() 메서드를 호출하여 컬렉션 에 있는 문서 수의 추정치를 조회 할 수 있습니다. 이 메서드는 컬렉션 메타데이터 를 기반으로 문서의 양을 추정하며, 이는 정확한 개수를 계산하는 것보다 빠를 수 있습니다.

다음 예에서는 컬렉션의 문서 수를 추정합니다.

$result = $collection->estimatedDocumentCount();
echo 'Estimated number of documents: ', $result;
Estimated number of documents: 9500

옵션 값을 매개 변수로 지정하는 배열 을 전달하여 estimatedDocumentCount() 메서드의 동작을 수정할 수 있습니다. 다음 표에서는 배열 에서 설정하다 수 있는 옵션에 대해 설명합니다.

옵션
설명

comment

The comment to attach to the operation.
Type: any valid BSON type

maxTimeMS

The maximum amount of time in milliseconds that the operation can run.
Type: integer

readConcern

The read concern to use for the operation. To learn more, see Read Concern in the Server manual.
Type: MongoDB\Driver\ReadConcern

readPreference

The read preference to use for the operation. To learn more, see Read Preference in the Server manual.
Type: MongoDB\Driver\ReadPreference

session

The client session to associate with the operation.
Type: MongoDB\Driver\Session

다음 예시 에서는 estimatedDocumentCount() 메서드를 사용하여 컬렉션 에 있는 문서 수의 추정치를 반환하고 작업에 1000 밀리초의 시간 제한을 설정합니다.

$result = $collection->estimatedDocumentCount(['maxTimeMS' => 1000]);
echo 'Estimated number of documents: ', $result;
Estimated number of documents: 9500

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.