Docs 菜单
Docs 主页
/
数据库手册
/ / /

游标()(mongosh方法)

cursor.batchSize(size)

重要

mongosh 方法

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

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

查询结果中每批次可返回的最大文档数量。默认情况下,初始批处理大小是 101 个文档或 16 个兆字节(MiB)文档中的较小者。后续批处理的最大大小为 16 MiB。此选项可以执行比 16 MiB 更小的限制,但不能执行更大的限制。设置后,batchSizebatchSize 份文档或 16 MiB 文档中较小的一个。

batchSize0 是指将建立游标,但第一批不会返回任何文档。

注意

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

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

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

字段
类型
说明

size

整型

批处理查询结果中可以返回的最大文档数。默认初始批处理大小为 101 个文档或 16 MB (MiB) 文档中的较小者。后续批次的最大大小为 16 MiB。此选项可以实施小于 16 MiB 的限制,但不能执行大于 MiB 的限制。默认适用于驱动程序和Mongo Shell。 有关详细信息,请参阅 游标批处理。

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

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

注意

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

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

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

后退

游标.allowDiskUse

在此页面上