문서 수 계산

이 페이지의 내용

개요

이 가이드에서는 컬렉션에 있는 문서 수의 정확한 예상 개수를 검색하는 방법을 배울 수 있습니다.

컬렉션에 있는 문서 수를 계산하려면 count_documents() 메서드를 사용합니다. 특정 Atlas Search 기준과 일치하는 문서 수를 계산하려면 쿼리 필터가 포함된 사전을 count_documents() 메서드에 전달합니다.

쿼리 지정에 학습 보려면 쿼리 지정을 참조하세요.

컬렉션에 있는 모든 문서의 개수를 반환하려면 다음 예제와 같이 빈 사전을 count_documents() 메서드에 전달합니다.

collection.count_documents({})

특정 Atlas Search 기준과 일치하는 문서 수를 반환하려면 다음 예와 같이 count_documents() 메서드에 쿼리를 지정합니다.

collection.count_documents({ "author": "Mike" })

count_documents() 메서드는 카운트 작업을 구성하는 데 사용할 수 있는 옵션을 나타내는 선택적 매개변수를 허용합니다. 옵션을 지정하지 않으면 드라이버는 카운트 작업을 사용자 지정하지 않습니다.

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

속성	설명
`comment`	A comment to attach to the operation.
`session`	An instance of `ClientSession`.
`skip`	The number of documents to skip before returning results.
`limit`	The maximum number of documents to count. Must be a positive integer.
`maxTimeMS`	The maximum amount of time to allow the operation to run, in milliseconds.
`collation`	An instance of `Collation`.
`hint`	Gets or sets the index to scan for documents.

estimated_document_count() 메서드를 호출하여 컬렉션에 있는 문서 수의 추정치를 얻을 수 있습니다. 이 메서드는 컬렉션 메타데이터를 기반으로 문서의 양을 추정하며, 이는 정확한 개수를 계산하는 것보다 빠를 수 있습니다.

다음 예에서는 컬렉션의 문서 수를 추정합니다.

collection.estimated_document_count()

estimated_document_count() 메서드는 카운트 작업을 구성하는 데 사용할 수 있는 옵션을 나타내는 선택적 매개변수를 허용합니다. 옵션을 지정하지 않으면 드라이버는 카운트 작업을 사용자 지정하지 않습니다.

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

속성	설명
`comment`	A comment to attach to the operation.
`maxTimeMS`	The maximum amount of time to allow the operation to run, in milliseconds.

PyMongo는 더 이상 count() 메서드를 지원하지 않습니다. 대신 Collection 클래스의 count_documents() 메서드를 사용합니다.

count_documents() 메서드는 Collection 클래스에 속합니다. Cursor.count_documents() 를 호출하려고 하면 PyMongo에서 다음 오류가 발생합니다.

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'Cursor' object has no attribute 'count'

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.