cursor.batchSize()

정의

cursor.batchSize(size)

중요

Mongo쉬 방법

이 페이지에서는 mongosh 메서드를 설명합니다. 이는 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.

MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

쿼리 결과의 각 배치 에서 반환될 수 있는 최대 문서 수입니다. 기본값 으로 초기 배치 크기는 101 문서 또는 16 메비바이트(MiB) 상당의 문서 중 더 작은 값입니다. 후속 배치의 최대 크기는 16 MiB입니다. 이 옵션은 16 MiB보다 작은 한도를 시행하다 할 수 있지만 더 큰 한도는 적용할 수 없습니다. batchSize 설정하다 하면 batchSize 문서 또는 16 MiB 가치의 문서 중 더 작은 값이 됩니다.

0 의 batchSize 은 커서 설정되었지만 첫 번째 배치 에서 문서가 반환되지 않음을 의미합니다.

참고

배치 크기가 너무 크면 커서가 필요한 것보다 더 많은 리소스를 할당하여 쿼리 성능에 부정적인 영향을 미칠 수 있습니다. 배치 크기가 너무 작으면 커서가 쿼리 결과를 검색하는 데 더 많은 네트워크 왕복이 필요하므로 쿼리 성능에 부정적인 영향을 미칠 수 있습니다.

batchSize를 데이터베이스, 로드 및 애플리케이션 요구 사항에 적합한 값으로 조정합니다.

batchSize() 메서드는 다음 필드를 사용합니다.

필드	유형	설명
size	integer	쿼리 결과의 각 배치 에서 반환될 수 있는 최대 문서 수입니다. 기본값 초기 배치 크기는 더 작은 또는 101 문서 또는 16 메비바이트(MiB) 상당의 문서입니다. 후속 배치의 최대 크기는 16 MiB입니다. 이 옵션은 16 MiB보다 작은 한도를 시행하다 할 수 있지만 더 큰 한도는 적용할 수 없습니다. 기본값 드라이버와 Mongo Shell에 적용됩니다. 자세한 내용은 커서 배치를 참조하세요.

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

• MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

예시

다음 예시에서는 쿼리 결과(구체적으로 find())에 대한 batchSize를 10으로 설정합니다.

db.inventory.find().batchSize(10)

자세히 알아보기

• 커서 배치

• cursor.next()

• getMore