cursor.batchSize()

정의

cursor.batchSize(size)

중요

Mongo쉬 방법

이는 mongosh 메서드입니다. 이는 Node.js 또는 기타 프로그래밍 언어별 드라이버 메서드에 대한 설명서가 아닙니다 .

대부분의 경우 mongosh 메서드는 레거시 mongo shell 메서드와 동일한 방식으로 작동합니다. 그러나 일부 레거시 메서드는 mongosh 에서 사용할 수 없습니다.

레거시 mongo 셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.

• Mongo 셸 V4.4

• mongo shell v4.2

• mongo 셸 v4.0

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

MongoDB 인스턴스의 각 응답 배치에서 반환할 문서 수를 지정합니다. 대부분의 경우 배치 크기를 수정해도 mongosh 및 대부분의 드라이버는 MongoDB가 단일 배치를 반환한 것처럼 결과를 반환하므로 사용자 또는 애플리케이션에 영향을 주지 않습니다.

참고

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

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

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

필드	유형	설명
size	integer	배치에 대해 반환할 초기 문서 수입니다. 기본 초기 배치 크기는 101 문서입니다. 후속 배치는 16 메가바이트입니다. 기본값은 드라이버와 Mongo Shell에 적용됩니다. 자세한 내용은 커서 배치를 참조하세요.

호환성

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

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

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

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

예시

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

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

자세히 알아보기

• 커서 배치

• cursor.next()

• getMore