cursor.batchSize()

定義

cursor.batchSize(size)

重要

mongosh メソッド

このページでは、mongosh メソッドについて記載しています。これは Node.js などの言語固有のドライバーのドキュメントではありません。

MongoDB API ドライバーについては、各言語の MongoDB ドライバー ドキュメントを参照してください。

クエリ結果の各バッチするで返されるドキュメントの最大数。デフォルトでは 、初期バッチするサイズは 101 ドキュメントまたはドキュメントの 16 メビバイト（MiB）値のうち小さい方です。それ以降のバッチの最大サイズは 16 MiB です。このオプションを使用すると、16 MiB より小さい制限が適用できますが、超えることはありません。設定すると、batchSize は batchSize ドキュメントまたは 16 MiB 値のドキュメントのうち小さい方です。

0 の batchSize は、カーソルは作成されているが、 最初のバッチするではドキュメントは返されないことを意味します。

注意

バッチ サイズが大きすぎると、カーソルにより必要以上に多くのリソースが割り当てられるため、クエリのパフォーマンスに悪影響を及ぼす可能性があります。バッチ サイズが小さすぎると、クエリ結果を取得するためにカーソルによるネットワーク ラウンド トリップが増え、クエリのパフォーマンスに悪影響を及ぼす可能性があります。

batchSize をデータベース、ロード、およびアプリケーションのニーズに適した値に調整します。

batchSize() メソッドは次のフィールドを受け取ります。

フィールド	タイプ	説明
size	integer	クエリ結果の各バッチするで返されるドキュメントの最大数。デフォルトの初期バッチするサイズは、101 16ドキュメントまたはドキュメントの メビバイト（MiB）の値が小さい方です。それ以降のバッチの最大サイズは16 MiB です。このオプションを使用すると、16 MiB より小さい制限が適用できますが、超えることはありません。デフォルトはドライバーとMongo Shell に適用されます。詳細については、「 カーソルバッチ 」を参照してください。

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

• MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

例

次の例では、クエリの結果（具体的には、find()）の batchSize を 10 に設定します。

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

詳細

• カーソル バッチ

• cursor.next()

• getMore