MongoDB\Collection::countDocuments()
이 페이지의 내용
버전 1.4에 새로 추가되었습니다.
정의
매개변수
$filter: 배열|객체- 계산할 문서를 지정하는 필터 기준입니다.
$options: 배열원하는 옵션을 지정하는 배열입니다.
이름유형설명데이터 정렬
배열|객체
데이터 정렬 을 통해 사용자는 string 비교를 위한 언어별 규칙(예: 대소문자 및 악센트 표시 규칙)을 지정할 수 있습니다. 데이터 정렬을 지정할 때
locale필드는 필수입니다. 다른 모든 데이터 정렬 필드는 선택 사항입니다. 필드에 대한 설명은 데이터 정렬 문서를 참조하세요.데이터 정렬이 지정되지 않았지만 컬렉션에 기본 데이터 정렬이 있는 경우, 작업은 컬렉션에 지정된 데이터 정렬을 사용합니다. 컬렉션 또는 연산에 대한 데이터 정렬이 지정되지 않은 경우, MongoDB는 이전 버전에서 문자열 비교에 사용된 간단한 이진 비교를 사용합니다.
comment
혼합
사용자가 데이터베이스 프로파일러, currentOp 출력 및 로그를 통해 작업을 추적하는 데 도움이 되는 임의의 주석을 지정할 수 있습니다.
MongoDB 4.4 버전부터는 유효한 모든 BSON type을 주석으로 설정할 수 있습니다. 이전 서버 버전에서는 문자열 값만 지원합니다.
hint
문자열|배열|객체
사용할 인덱스입니다. 인덱스 이름을 문자열로 지정하거나 인덱스 키 패턴을 문서로 지정합니다. 이 옵션을 지정하면 쿼리 시스템은 힌트 인덱스를 사용하는 계획만 고려합니다.
limit
integer
반환할 일치 문서의 최대 개수입니다.
최대 시간 (MS)
integer
커서에서 작업을 처리하는 데 걸리는 누적 시간 제한(밀리초)입니다. MongoDB는 중단 지점 이후 가장 빠른 시점에 작업을 중단합니다.
readConcern
읽기 설정
작업에 사용할 읽기 설정 입니다. 기본값은 컬렉션의 읽기 설정입니다.
Session
작업과 연결할 클라이언트 세션입니다.
건너뛰기
integer
결과를 반환하기 전에 건너뛸 일치하는 문서의 수입니다.
Return Values
필터 기준과 일치하는 문서 수입니다.
오류/예외
MongoDB\Exception\UnexpectedValueException 서버의 명령 응답이 잘못된 경우입니다.
옵션이 사용되지만 선택한 서버에서 지원되지 않는 경우 MongoDB\Exception\UnsupportedException입니다(예: collation, readConcern, writeConcern).
MongoDB\Exception\InvalidArgumentException 매개변수 또는 옵션의 구문 분석과 관련된 오류의 경우입니다.
MongoDB\ 드라이버\Exception\RuntimeException 확장 수준의 다른 오류(예: 연결 오류).
행동
내부적으로 이 메서드는 $group 집계 파이프라인 연산자를 사용하여 결과를 얻습니다. filter 매개변수가 제공되면 이는 $match 파이프라인 연산자로 변환됩니다. 옵션에 선택적 $skip 및 $limit 단계가 있는 경우 $match 와 group 사이에 추가됩니다.
참고
이 메서드는 서버 측의 문서 수를 계산합니다. 필터를 적용하지 않은 대략적인 총 문서 수를 구하려면 MongoDB\Collection::estimatedDocumentCount() 메서드를 사용할 수 있습니다. 이 방법은 collection 메타데이터를 기반으로 문서 수를 추정하므로 성능의 정확성이 희생됩니다.
이 메서드는 집계 파이프라인을 사용하므로 MongoDB\Collection::count() filter 내에서 허용되는 일부 쿼리 연산자를 사용할 수 없습니다. 이러한 제한된 연산자에 대한 다음 대안을 고려하세요.
쿼리 기준을 평가할 때 MongoDB 는 BSON types에 대한 자체 비교 규칙 에 따라 유형과 값을 비교하며, 이는 PHP의 비교 와는 다릅니다. 및 유형 저글링 규칙. 특수 BSON 유형과 일치하는 경우 쿼리 기준은 해당 BSON 클래스 를 사용해야 합니다. 확장 프로그램(예: MongoDB\ BSON\ObjectId 사용 ObjectId 와 일치시킵니다.