cursor.batchSize()

定義

cursor.batchSize(size)

重要

mongosh メソッド

これはmongoshメソッドです。 これは、 Node.jsまたはその他のプログラミング言語固有のドライバー メソッドのドキュメントではありません。

ほとんどの場合、 mongoshメソッドはレガシーの mongo shell メソッドと同じように動作します。 ただし、一部のレガシー メソッドはmongoshでは利用できません。

レガシーmongo shell のドキュメントについては、対応する MongoDB Server リリースのドキュメントを参照してください。

• mongo shell v4.4

• mongo shell v4.2

• mongo shell v4.0

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