문서 수 계산
개요
이 가이드 에서는 스칼라 운전자 사용하여 컬렉션 에 있는 문서 수의 정확한 예상 개수를 조회 방법을 학습 수 있습니다. 다음 메서드는 컬렉션 의 문서 수를 계산합니다.
countDocuments()
: 쿼리 필터하다 와 일치하거나 컬렉션 에 존재하는 문서의 정확한 수를 반환합니다.estimatedDocumentCount()
: 컬렉션 의 예상 문서 수를 반환합니다.
샘플 데이터
이 가이드 의 예제에서는 companies
sample_training
Atlas 샘플 데이터 세트의 데이터베이스 에 있는 컬렉션 사용합니다. 스칼라 애플리케이션 에서 이 컬렉션 액세스 하려면 MongoClient
Atlas cluster 에 연결하는 를 만들고 및 변수에 다음 값을 할당합니다.database
collection
val database: MongoDatabase = mongoClient.getDatabase("sample_training") val collection: MongoCollection[Document] = database.getCollection("companies")
무료 MongoDB Atlas cluster 를 생성하고 샘플 데이터 세트를 로드하는 방법을 학습 보려면 Atlas 시작하기 가이드 를 참조하세요.
정확한 개수 조회
컬렉션 의 문서 수를 계산하려면 countDocuments()
메서드를 사용합니다. 특정 검색 기준과 일치하는 문서 수를 계산하려면 countDocuments()
메서드에 쿼리 필터하다 를 전달합니다.
쿼리 지정에 학습 보려면 쿼리 지정 가이드 를 참조하세요.
모든 문서 계산
컬렉션 에 있는 모든 문서의 개수를 반환하려면 다음 예시 와 같이 매개변수를 전달하지 않고 countDocuments()
메서드를 호출합니다.
collection.countDocuments() .subscribe((count: Long) => println(s"Number of documents: $count"), (e: Throwable) => println(s"There was an error: $e"))
Number of documents: 9500
특정 문서 수 계산
특정 검색 기준과 일치하는 문서 수를 반환하려면 countDocuments()
메서드에 쿼리 필터하다 를 전달합니다.
다음 예시 에서는 founded_year
필드 의 값이 2010
인 문서 수를 계산합니다.
collection.countDocuments(equal("founded_year", 2010)) .subscribe((count: Long) => println(s"Companies founded in 2010: $count"), (e: Throwable) => println(s"There was an error: $e"))
Number of companies founded in 2010: 33
카운트 동작 사용자 지정
CountOptions
인스턴스 매개변수로 전달하여 countDocuments()
메서드의 동작을 수정할 수 있습니다. 다음 표에서는 카운트 작업에 대한 옵션을 설정하다 데 사용할 수 있는 CountOptions
클래스의 일부 멤버 함수에 대해 설명합니다.
메서드 | 설명 |
---|---|
| Sets the collation to use for the operation. Parameter Type: Collation |
| Sets the index to use for the operation. ParameterType: Bson |
| Sets the maximum number of documents to count. This value must be a positive integer. Parameter Type: int |
| Sets the maximum amount of time that the operation can run. Parameter Types: long and TimeUnit |
| Sets the number of documents to skip before counting documents. Parameter Type: int |
다음 예시 에서는 countDocuments()
메서드를 사용하여 number_of_employees
필드 의 값이 50
인 문서 수를 계산하고 최대 100
결과를 계산하도록 작업에 지시합니다.
val countOptions = CountOptions().limit(100) collection.countDocuments(equal("number_of_employees", 50), countOptions) .subscribe((count: Long) => println(s"Companies with 50 employees: $count"), (e: Throwable) => println(s"There was an error: $e"))
Number of companies with 50 employees: 100
예상 개수 조회
estimatedDocumentCount()
메서드를 호출하여 컬렉션 에 있는 문서 수의 추정치를 조회 할 수 있습니다. 이 메서드는 컬렉션 메타데이터 를 기반으로 문서의 양을 추정하며, 이는 정확한 개수를 계산하는 것보다 빠를 수 있습니다.
다음 예에서는 컬렉션의 문서 수를 추정합니다.
collection.estimatedDocumentCount() .subscribe((count: Long) => println(s"Estimated number of documents: $count"), (e: Throwable) => println(s"There was an error: $e"))
Estimated number of documents: 9500
예상 카운트 동작 사용자 지정
EstimatedDocumentCountOptions
인스턴스 매개변수로 전달하여 estimatedDocumentCount()
메서드의 동작을 수정할 수 있습니다. EstimatedDocumentCountOptions
클래스에는 EstimatedDocumentCountOptions
객체 구성하고 카운트 작업이 실행 수 있는 최대 시간을 설정하다 데 사용할 수 있는 maxTime()
멤버 함수가 포함되어 있습니다.
다음 예시 estimatedDocumentCount()
메서드를 사용하여 컬렉션 에 있는 문서 수의 추정치를 반환하고 작업에 3
초의 시간 제한을 설정합니다.
val estimatedOptions = EstimatedDocumentCountOptions().maxTime(3, SECONDS) collection.estimatedDocumentCount(estimatedOptions) .subscribe((count: Long) => println(s"Estimated number of documents: $count"), (e: Throwable) => println(s"There was an error: $e"))
Estimated number of documents: 9500
API 문서
이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.