cursor.batchSize()

정의

cursor.batchSize(size)

중요

Mongo쉬 방법

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

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