cursor.batchSize()（mongoshメソッド）

定義

cursor.batchSize(size)

重要

mongosh メソッド

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）相当のドキュメントのうち、少ない方となります。以降のバッチの最大サイズは 16 メビバイト（MiB）です。このオプションは、16 メビバイト（MiB）より小さい制限を強制することはできますが、それを超える制限を設定することはできません。設定されている場合、batchSize は batchSize 件のドキュメントまたは 16 メビバイト（MiB）相当のドキュメントのうち、少ない方になります。

シャーディングされたクラスターでは、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