/ /

/ /

문서 수 계산

개요

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

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

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

컬렉션 에 있는 모든 문서의 개수를 반환하려면 다음 예시 와 같이 빈 사전을 count_documents() 메서드에 전달합니다. Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

collection.count_documents({})

await collection.count_documents({})

특정 검색 기준과 일치하는 문서 수를 반환하려면 다음 예시 와 같이 count_documents() 메서드에 쿼리 지정합니다. Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

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

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

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

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

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

다음 예시 에서는 컬렉션 의 문서 수를 추정합니다. Synchronous 또는 Asynchronous 탭 선택하여 해당 코드를 확인합니다.

collection.estimated_document_count()

await collection.estimated_document_count()

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

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

속성	설명
`comment`	작업에 첨부할 주석입니다.
`maxTimeMS`	작업 실행을 허용하는 최대 시간(밀리초)입니다.

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 설명서를 참조하세요.

돌아가기

반환할 필드 지정

고유 필드 값