cursor.batchSize()

정의

cursor.batchSize(size)

중요

Mongo쉬 방법

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

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

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

참고

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

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

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

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

예시

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

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

자세히 알아보기

• 커서 배치

• cursor.next()

• getMore