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	작업에 사용할 읽기 고려 입니다. 기본값은 컬렉션의 읽기 고려입니다. 트랜잭션의 일부로 개별 작업에 대한 읽기 고려를 지정할 수 없습니다. 대신 트랜잭션을시작할 때 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 명령을 사용하여 구현됩니다. MongoDB 5.0.0~5.0.8 버전의 실수로 인해 count 명령이 Stable API 의 버전 '1'에 포함되지 않았습니다. Stable API 와 함께 이 메서드를 사용하는 애플리케이션은 서버 버전을 5 로 업그레이드 하는 것이 좋습니다.0.9+ 또는 엄격 모드 를 비활성화하여 오류가 발생하지 않도록 합니다.

다음도 참조하세요.

• MongoDB 매뉴얼의 count 명령 참조

• MongoDB\Collection::countDocuments()