Docs 菜单

cursor.batchSize()

cursor.batchSize(size)

重要

mongosh 方法

本页面提供 mongosh 方法的相关信息。这不是 特定于语言的驱动程序(例如 Node.js)的文档。

如需了解 MongoDB API 驱动程序,请参阅特定语言的 MongoDB 驱动程序文档。

指定来自 MongoDB 实例的每批响应中要返回的文档数。在大多数情况下,修改批处理大小不会影响用户或应用程序,因为 mongosh 和大多数驱动程序返回结果与 MongoDB 返回单个批处理类似。

注意

如果批处理大小太大,则游标分配的资源会超过其所需,这可能会对查询性能产生负面影响。 如果批处理大小太小,则游标需要更多的网络往返来检索查询结果,这会对查询性能产生负面影响。

batchSize 调整为适合您的数据库、负载和应用程序需求的值。

batchSize() 方法采用以下字段:

字段
类型
说明

size

整型

要为批处理返回的初始文档数。 默认初始批处理大小为 101 个文档。 后续批次的大小为 16 MB。 默认适用于驱动程序和Mongo Shell。 有关详细信息,请参阅游标批处理。

此方法可用于以下环境中托管的部署:

注意

所有 MongoDB Atlas 集群都支持此命令。有关 Atlas 对所有命令的支持的信息,请参阅不支持的命令

以下示例将查询结果(具体来说,即 find())的 batchSize 设置为 10

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