문서 수 계산
개요
이 가이드 에서는 컬렉션 에 있는 문서 수의 정확한 개수와 예상 개수를 조회 하는 방법에 학습 수 있습니다.
샘플 데이터
이 가이드 의 예제에서는 Atlas 샘플 데이터 세트 의 sample_mflix 데이터베이스 에 있는 movies 컬렉션 을 사용합니다. 무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 Atlas 시작하기 가이드 를 참조하세요.
다음 코틀린 (Kotlin) 데이터 클래스는 이 컬렉션 의 문서를 모델링합니다.
data class Movie( val id: ObjectId, val title: String )
정확한 개수 조회
컬렉션 에 있는 문서 수를 계산하려면 countDocuments() 메서드를 사용합니다. 지정된 검색 기준과 일치하는 문서 수를 계산하려면 countDocuments() 메서드에 쿼리 필터하다 를 전달합니다.
쿼리 지정에 학습 보려면 쿼리 지정을 참조하세요.
모든 문서 계산
컬렉션 에 있는 모든 문서의 개수를 반환하려면 다음 예시 와 같이 인수 없이 countDocuments() 메서드를 호출합니다.
println(collection.countDocuments())
21349
특정 문서 수 계산
특정 검색 기준과 일치하는 문서 수를 반환하려면 countDocuments() 메서드에 쿼리 를 지정합니다. 다음 예시 에서는 movies 컬렉션 에서 year 필드 값이 1930 인 모든 문서의 개수를 출력합니다.
println(collection.countDocuments(eq("year", "1930")))
10
카운트 동작 사용자 지정
countDocuments() 메서드는 카운트 작업을 구성하는 데 사용할 수 있는 옵션을 나타내는 CountOptions 객체 형식의 선택적 매개변수를 허용합니다. 새 CountOptions 객체 를 인스턴스화하고 해당 메서드를 사용하여 객체의 필드를 설정한 다음 countDocuments() 메서드에 전달하여 이러한 옵션을 설정하다 수 있습니다. 옵션을 지정하지 않으면 운전자 는 카운트 작업을 사용자 지정하지 않습니다.
다음 표에서는 countDocuments() 을(를) 사용자 지정하기 위해 설정할 수 있는 옵션에 대해 설명합니다.
옵션 | 설명 |
|---|---|
comment | Specifies a comment to attach to the operation. |
skip | Sets the number of documents to skip before returning results. |
limit | Sets the maximum number of documents to count. Must be a positive integer. |
maxTime | Sets the maximum amount of time to allow the operation to run, in milliseconds. |
collation | Specifies the kind of language collation to use when sorting
results. For more information, see Collation
in the MongoDB Server manual. |
hint | Sets the index to scan for documents. |
다음 예시 에서는 CountOptions 객체 를 사용하여 countDocuments() 작업에 주석을 추가합니다.
val options = CountOptions().comment("Retrieving count") collection.countDocuments(Filters.empty(), options)
예상 개수 조회
컬렉션 에 있는 문서 수의 추정치를 조회 하려면 estimatedDocumentCount() 메서드를 사용합니다. 이 메서드는 컬렉션 메타데이터 를 기반으로 문서의 양을 추정하며, 이는 정확한 개수를 계산하는 것보다 빠를 수 있습니다.
다음 예시 에서는 컬렉션 의 예상 문서 수를 출력합니다.
print(collection.estimatedDocumentCount())
21349
예상 카운트 동작 사용자 지정
estimatedDocumentCount() 메서드는 카운트 작업을 구성하는 데 사용할 수 있는 옵션을 나타내는 EstimatedDocumentCountOptions 객체 형식의 선택적 매개변수를 허용합니다. 새 EstimatedDocumentCountOptions 객체 를 인스턴스화하고 해당 메서드를 사용하여 객체의 필드를 설정한 다음 estimatedDocumentCount() 메서드에 전달하여 이러한 옵션을 설정하다 수 있습니다. 옵션을 지정하지 않으면 운전자 는 카운트 작업을 사용자 지정하지 않습니다.
다음 표에서는 estimatedDocumentCount() 을(를) 사용자 지정하기 위해 설정할 수 있는 옵션에 대해 설명합니다.
옵션 | 설명 |
|---|---|
comment | Specifies a comment to attach to the operation. |
maxTime | Specifies the maximum amount of time to allow the operation to run, in milliseconds. |
다음 예시 에서는 EstimatedDocumentCountOptions 객체 를 사용하여 estimatedDocumentCount() 작업에 주석을 추가합니다.
val options = EstimatedDocumentCountOptions().comment("Retrieving count") collection.estimatedDocumentCount(options)
API 문서
이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.