Docs 菜单
Docs 主页
/
MongoDB Manual
/ / /

cursor.batchSize()

在此页面上

  • 定义
  • 兼容性
  • 例子
  • 了解详情
cursor.batchSize(size)

重要

mongosh 方法

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

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

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

注意

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

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

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

字段
类型
说明

size

整型

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

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

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

注意

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

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

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

后退

游标.allowPartialResults