Docs 菜单

Docs 主页 → 开发应用程序 → MongoDB Manual

getmore

在此页面上

  • 定义
  • 语法
  • 命令字段
  • 输出
  • 行为
  • 了解详情

定义

getMore

与返回游标的命令结合使用。例如，find 和 aggregate，用于返回游标当前指向的文档的后续批次。

语法

该命令具有以下语法：

db.runCommand(
   {
      getMore: <long>,
      collection: <string>,
      batchSize: <int>,
      maxTimeMS: <int>,
      comment: <any>
   }
)

命令字段

该命令接受以下字段：

字段
类型
说明
getMore
长整型
游标标识符。
collection
字符串
游标所操作的集合的名称。
batchSize
正整数

可选。该批次中待返回的文档数量。

如果未设置 batchSize，则 getMore 最多返回 16 MB 数据。如果已设置 batchSize，则 getMore 返回 16 MB 数据或 batchSize 文档中较小的一个。

maxTimeMS
非负整数

可选。

指定服务器等待出现与固定大小集合上可追加游标查询匹配的新文档的最长时间。对于可追加 awaitData 游标，getMore 上的 maxTimeMS 被认为与 maxAwaitTimeMS() 相同。驱动程序只会为固定大小集合上且 awaitData 设置为 true 的追加游标，在 getMore 上设置此值。否则，创建游标的命令会设置 maxTimeMS，这是初始操作和任何后续 getMore 操作可以累积执行查询所花费的最长时间。对于将 awaitData 设置为 true 的可追加游标，以下情况成立：

  • 如果未提供值，则等待时间默认为 1（1000 毫秒）。

  • maxTimeMS 在 getMore 上指定 MongoDB 等待将新文档插入特定 getMore 命令的固定大小集合的最长时间。

  • maxTimeMS 由驱动程序为每次调用 getMore 单独设置。

MongoDB 使用与 db.killOp() 相同的机制终止超过分配的时间限制的操作。MongoDB 仅在指定的中断点之一中终止操作。

  • 在不可追加游标上调用 getMore 时，无法设置 maxTimeMS。相反，请在创建游标时使用 maxTimeMS() 进行设置。

  • 要在可追加游标上使用 getMore 和 maxTimeMS，请在使用 cursor.tailable() 创建游标时启用 awaitData。

  • 在创建游标的命令上设置 maxTimeMS 仅设置该操作的时间限制。使用 getMore 为进一步的操作设限。

  • 您可以为每次调用 getMore 而设置或者可以省略 maxTimeMS，并且不必使用相同的值。

  • 对于可追加游标，getMore 的超时会保留游标中发生超时之前累积的文档。对于不可追加游标，超时会引发错误。

comment
注意到

可选。用户提供的待附加到该命令的注释。设置后，该注释将与该命令的记录一起出现在以下位置：

注释可以是任何有效的 BSON 类型（字符串、整型、对象、数组等）。

注意

如果省略，getMore 会继承在原始 find 或 aggregate 命令上设置的任何 comment。

输出

此命令会返回包含游标信息的文档以及下一批处理。

例如，在分片集群上通过 find 操作创建的游标上运行 getMore 会返回与以下输出类似的文档：

{
   "cursor" : {
      "id" : NumberLong("678960441858272731"),
      "ns" : "test.contacts",
      "nextBatch" : [
         {
            "_id" : ObjectId("5e8e501e1a32d227f9085857"),
            "zipcode" : "220000"
         }
      ],
      "partialResultsReturned" : true,
      "postBatchResumeToken": "< Resume Token >"
   },
   "ok" : 1,
   "operationTime" : Timestamp(1586385239, 2),
   "$clusterTime" : {
      "clusterTime" : Timestamp(1586385239, 2),
      "signature" : {
         "hash" : BinData(0,"lLjejeW6AQGReR9x1PD8xU+tP+A="),
         "keyId" : NumberLong("6813467763969884181")
      }
   }
}
字段
说明
cursor

包含游标信息，包括游标 ID 以及文档的 nextBatch。

如果find （或后续的 getMore命令）由于查询的分片不可用而返回部分结果，则find 输出将包含partialResultsReturned指示符字段。如果查询的分片可用于初始find命令，但一个或多个分片不可用于后续的getMore命令，则只有在分片不可用时运行的getMore命令才会在其输出中包含partialResultsReturned 。

postBatchResumeToken 字段可以与 $changeStream 管道一起使用，从此处开始或恢复变更流。

"ok"
表明命令是成功（1）还是失败（0）。

除这些字段外，db.runCommand() 响应还包括副本集和分片集群的以下信息：

  • $clusterTime

  • operationTime

请参阅 db.runCommand() 响应，了解详情。

行为

访问控制

如果启用了身份验证，那么您只能对您创建的游标运行 getMore。

会话

对于在会话内创建的游标，无法在会话外调用 getMore。

同样，对于在会话外创建的游标，无法在会话内调用 getMore。

事务

对于多文档事务：

  • 对于在事务外部创建的游标，无法在事务内部调用getMore 。

  • 对于在事务中创建的游标，您无法在事务外部调用getMore 。

慢查询

从 MongoDB 5开始。 1 ，当getMore命令记录为慢速查询时， queryHash和planCacheKey字段将添加到慢速查询日志消息和分析器日志消息中。

了解详情

在 mongosh 中迭代游标 mongosh

← getLastError
插入 →

在此页面上