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