개요
이 가이드 에서는 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()
메서드의 동작을 수정할 수 있습니다. 다음 표에서는 카운트 작업을 사용자 지정하기 위해 설정하다 수 있는 몇 가지 옵션을 설명합니다.
옵션 | 설명 |
---|---|
| The collation to use for the operation. To learn more,
see the Collation section of this page. Type: array|object |
| The index to use for the operation. Type: string|array|object |
| The comment to attach to the operation. Type: any valid BSON type |
| The maximum number of documents to count. This value must be a positive integer. Type: integer |
| The maximum amount of time in milliseconds that the operation can run. Type: integer |
| The number of documents to skip before counting documents. Type: integer |
| 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
데이터 정렬
작업에 대한 데이터 정렬을 지정하려면 collation
옵션을 설정하는 $options
배열 매개변수를 작업 메서드에 전달합니다. 데이터 정렬 규칙을 구성하는 배열 에 collation
옵션을 할당합니다.
다음 표에서는 데이터 정렬을 구성하기 위해 설정하다 수 있는 필드에 대해 설명합니다.
필드 | 설명 |
---|---|
| (Required) Specifies the International Components for Unicode (ICU) locale. For a
list of supported locales, see Collation Locales and Default Parameters
in the MongoDB Server manual. Data Type: string |
| (Optional) Specifies whether to include case comparison. When set to true , the comparison behavior depends on the value of
the strength field:- If strength is 1 , the PHP library compares basecharacters and case. - If strength is 2 , the PHP library compares basecharacters, diacritics, other secondary differences, and case. - If strength is any other value, this field is ignored.When set to false , the PHP library doesn't include case comparison at
strength level 1 or 2 .Data Type: bool Default: false |
| (Optional) Specifies the sort order of case differences during tertiary
level comparisons. Data Type: string Default: "off" |
| (Optional) Specifies the level of comparison to perform, as defined in the
ICU documentation. Data Type: int Default: 3 |
| (Optional) Specifies whether the driver compares numeric strings as numbers. If set to true , the PHP library compares numeric strings as numbers.
For example, when comparing the strings "10" and "2", the library uses the
strings' numeric values and treats "10" as greater than "2".If set to false , the PHP library compares numeric strings
as strings. For example, when comparing the strings "10" and "2", the library
compares one character at a time and treats "10" as less than "2".For more information, see Collation Restrictions
in the MongoDB Server manual. Data Type: bool Default: false |
| (Optional) Specifies whether the library considers whitespace and punctuation as base
characters for comparison purposes. Data Type: string Default: "non-ignorable" |
| (Optional) Specifies which characters the library considers ignorable when
the alternate field is set to "shifted" .Data Type: string Default: "punct" |
| (Optional) Specifies whether strings containing diacritics sort from the back of the string
to the front. Data Type: bool Default: false |
데이터 정렬 및 각 필드에 사용할 수 있는 값에 대해 자세히 학습하려면 MongoDB Server 매뉴얼의 데이터 정렬 항목을 참조하세요.
예상 개수 조회
MongoDB\Collection::estimatedDocumentCount()
메서드를 호출하여 컬렉션 에 있는 문서 수의 추정치를 조회 할 수 있습니다. 이 메서드는 컬렉션 메타데이터 를 기반으로 문서의 양을 추정하며, 이는 정확한 개수를 계산하는 것보다 빠를 수 있습니다.
다음 예에서는 컬렉션의 문서 수를 추정합니다.
$result = $collection->estimatedDocumentCount(); echo 'Estimated number of documents: ', $result;
Estimated number of documents: 9500
예상 카운트 동작 사용자 지정
옵션 값을 매개 변수로 지정하는 배열 을 전달하여 estimatedDocumentCount()
메서드의 동작을 수정할 수 있습니다. 다음 표에서는 배열 에서 설정하다 수 있는 옵션에 대해 설명합니다.
옵션 | 설명 |
---|---|
| The comment to attach to the operation. Type: any valid BSON type |
| The maximum amount of time in milliseconds that the operation can run. Type: integer |
| The read concern to use for the operation. To learn more, see
Read Concern in the Server manual. Type: MongoDB\Driver\ReadConcern |
| The read preference to use for the operation. To learn more, see
Read Preference in the Server manual. Type: MongoDB\Driver\ReadPreference |
| 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 문서
이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.