cursor.batchSize()
定義
cursor.batchSize(size)
重要
mongosh メソッド
これは
mongosh
メソッドです。 これは、Node.js
またはその他のプログラミング言語固有のドライバー メソッドのドキュメントではありません。ほとんどの場合、
mongosh
メソッドはレガシーのmongo
shell メソッドと同じように動作します。 ただし、一部のレガシー メソッドはmongosh
では利用できません。レガシー
mongo
shell のドキュメントについては、対応する MongoDB Server リリースのドキュメントを参照してください。MongoDB API ドライバーについては、各言語のMongoDB ドライバードキュメント を参照してください。
MongoDB インスタンスからの応答の各バッチで返すドキュメントの数を指定します。ほとんどの場合、バッチ サイズを変更してもユーザーやアプリケーションには影響しません。
mongosh
およびほとんどのドライバーは、MongoDB が単一のバッチを返したかのような結果を返します。注意
バッチ サイズが大きすぎると、カーソルが必要以上に多くのリソースを割り当てるため、クエリのパフォーマンスに悪影響を及ぼす可能性があります。バッチ サイズが小さすぎると、カーソルがクエリ結果を取得するためのネットワーク ラウンド トリップが増え、クエリのパフォーマンスに悪影響を及ぼす可能性があります。
batchSize
をデータベース、ロード、およびアプリケーションのニーズに適した値に調整します。batchSize()
メソッドは次のフィールドを受け取ります。フィールドタイプ説明size
integerバッチするで返すドキュメントの初期数。デフォルトの初期バッチするサイズは101ドキュメントです。それ以降のバッチするは16メガバイトである。デフォルトはドライバーと Mongo Shell に適用されます。 詳細については、「カーソルバッチ」を参照してください。
例
次の例では、クエリの結果(具体的には、find()
)の batchSize
を 10
に設定します。
db.inventory.find().batchSize(10)