MongoDB\Collection::estimatedDocumentCount()

정의

MongoDB\Collection::estimatedDocumentCount()

컬렉션 메타데이터를 사용하여 컬렉션의 예상 문서 수를 가져옵니다.

function countDocuments(array $options = []): integer

매개변수

$options : 배열

원하는 옵션을 지정하는 배열입니다.

이름	유형	설명
comment	혼합	사용자가 데이터베이스 프로파일러, currentOp 출력 및 로그를 통해 작업을 추적하는 데 도움이 되는 임의의 주석을 지정할 수 있습니다. 이 옵션은 MongoDB 4.4부터 사용할 수 있으며 이전 서버 버전에 대해 지정된 경우 실행 시 예외가 발생합니다. 버전 1.13에 새로 추가되었습니다.
최대 시간 (MS)	integer	커서에서 작업을 처리하는 데 걸리는 누적 시간 제한(밀리초)입니다. MongoDB는 중단 지점 이후 가장 빠른 시점에 작업을 중단합니다.
readConcern	MongoDB\Driver\ReadConcern	작업에 사용할 읽기 고려 입니다. 기본값은 컬렉션의 읽기 고려입니다. 트랜잭션 의 일부로 개별 작업에 대한 읽기 고려 (read concern) 지정할 수 없습니다. 대신 readConcern 트랜잭션 시작할 때 옵션을 설정하다 .
읽기 설정	MongoDB\Driver\ReadPreference	작업에 사용할 읽기 설정 입니다. 기본값은 컬렉션의 읽기 설정입니다.
Session	MongoDB\Driver\Session	작업과 연결할 클라이언트 세션입니다.

Return Values

collection의 예상 문서 수입니다.

오류/예외

MongoDB\Exception\UnexpectedValueException 서버의 명령 응답이 잘못된 경우입니다.

옵션이 사용되지만 선택한 서버에서 지원되지 않는 경우 MongoDB\Exception\UnsupportedException입니다(예: collation, readConcern, writeConcern).

MongoDB\Exception\InvalidArgumentException 매개변수 또는 옵션의 구문 분석과 관련된 오류의 경우입니다.

확장 수준의 기타 오류(예: 연결 오류)에 대한MongoDB\ 드라이버\Exception\RuntimeException입니다.

행동

이 메서드는 문서 수를 계산하거나 인덱스 를 컨설팅 하는 대신 컬렉션 메타데이터 를 사용하여 컬렉션 에 있는 문서 수의 추정치를 반환합니다. 이 메서드는 session 옵션을 사용하지 않으며 트랜잭션 내에서 실행할 수 없습니다. 자세한 내용은 MongoDB 매뉴얼의 개수: 동작 을 참조하세요.

이 메서드는 count 명령을 사용하여 구현됩니다. count 명령은 Stable API 의 버전 '1'에 포함되어 있지 않습니다. Stable API 와 함께 이 메서드를 사용하는 경우 오류가 발생하지 않도록 서버 버전을 5.0.9+로 업그레이드하거나 엄격 모드 비활성화하는 것이 좋습니다.

다음도 참조하세요.

• MongoDB 매뉴얼의 count 명령 참조

• MongoDB\Collection::countDocuments()