문서 수 계산

샘플 데이터

이 가이드의 예시에서는 Atlas 샘플 데이터 세트의 sample_mflix 데이터베이스에 있는 movies 컬렉션을 사용합니다. 무료 MongoDB 배포서버를 생성하고 샘플 데이터 세트를 로드하는 방법을 알아보려면 MongoDB 시작하기 가이드를 참조하세요.

다음 코틀린 (Kotlin) 데이터 클래스는 이 컬렉션 의 문서를 모델링합니다.

data class Movie(
    @BsonId
    val id: ObjectId,
    val title: String
)

모든 문서 계산

컬렉션 에 있는 모든 문서의 개수를 반환하려면 다음 예시 와 같이 인수 없이 countDocuments() 메서드를 호출합니다.

println(collection.countDocuments())

21349

특정 문서 수 계산

특정 검색 기준과 일치하는 문서 수를 반환하려면 countDocuments() 메서드에 쿼리 를 지정합니다. 다음 예시 에서는 movies 컬렉션 에서 year 필드 값이 1930 인 모든 문서의 개수를 출력합니다.

println(collection.countDocuments(eq("year", "1930")))

10

카운트 동작 사용자 지정

countDocuments() 메서드는 카운트 작업을 구성하는 데 사용할 수 있는 옵션을 나타내는 CountOptions 객체 형식의 선택적 매개변수를 허용합니다. 새 CountOptions 객체 를 인스턴스화하고 해당 메서드를 사용하여 객체의 필드를 설정한 다음 countDocuments() 메서드에 전달하여 이러한 옵션을 설정하다 수 있습니다. 옵션을 지정하지 않으면 운전자 는 카운트 작업을 사용자 지정하지 않습니다.

다음 표에서는 countDocuments() 을(를) 사용자 지정하기 위해 설정할 수 있는 옵션에 대해 설명합니다.

다음 예시 에서는 CountOptions 객체 를 사용하여 countDocuments() 작업에 주석을 추가합니다.

val options = CountOptions().comment("Retrieving count")
collection.countDocuments(Filters.empty(), options)

예상 카운트 동작 사용자 지정

estimatedDocumentCount() 메서드는 카운트 작업을 구성하는 데 사용할 수 있는 옵션을 나타내는 EstimatedDocumentCountOptions 객체 형식의 선택적 매개변수를 허용합니다. 새 EstimatedDocumentCountOptions 객체 를 인스턴스화하고 해당 메서드를 사용하여 객체의 필드를 설정한 다음 estimatedDocumentCount() 메서드에 전달하여 이러한 옵션을 설정하다 수 있습니다. 옵션을 지정하지 않으면 운전자 는 카운트 작업을 사용자 지정하지 않습니다.

다음 표에서는 estimatedDocumentCount() 을(를) 사용자 지정하기 위해 설정할 수 있는 옵션에 대해 설명합니다.

다음 예시 에서는 EstimatedDocumentCountOptions 객체 를 사용하여 estimatedDocumentCount() 작업에 주석을 추가합니다.

val options = EstimatedDocumentCountOptions().comment("Retrieving count")
collection.estimatedDocumentCount(options)