커서.batchSize() (mongosh 메서드)

정의

cursor.batchSize(size)

중요

Mongo쉬 방법

This page documents a mongosh method. This is not the documentation for a language-specific driver, such as Node.js.

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

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

샤딩된 클러스터에서 mongos은(는) batchSize 값을 개별 샤드로 전달하지 않습니다. 샤딩된 클러스터에서 후속 getMore 작업은 구성된 batchSize에 관계없이 배치당 최대 16 MiB의 문서를 반환합니다.

batchSize가 0이면 커서가 설정되지만 첫 번째 배치에서는 문서가 반환되지 않습니다.

참고

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

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

The batchSize() method takes the following field:

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

호환성

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

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

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

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

예시

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

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

자세히 알아보기

• 커서 배치

• cursor.next()

• getMore