对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
See how MongoDB 9.0 delivers up to 2x higher throughput.
MongoDB Branding Shape
Register now >
Docs 菜单

游标()(mongosh方法)

cursor.batchSize(size)

重要

mongosh 方法

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

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

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

在分片的集群中,mongos 不会将 batchSize 值转发到单个分片。无论配置的 batchSize 为何,分片集群中的后续 getMore 操作批处理最多返回 16 MiB 的文档。

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

注意

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

将 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)
给本页内容打分