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	整型	一批返回的初始文档数量。默认的初始批处理大小为 101 个文档。随后的批次为 16 兆字节。默认值适用于驱动程序和 Mongo Shell。有关详细信息，请参阅游标批处理。

兼容性

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

• MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

• MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

例子

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

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

了解详情

• 游标批处理

• cursor.next()

• getMore