/ /

getMore（数据库命令）

定义

getMore: 与返回游标的命令结合使用，例如 find 和 aggregate，从游标返回下一个文档批处理。

兼容性

此命令可用于以下环境中托管的部署：

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

注意

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

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

该命令具有以下语法：

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

命令字段

该命令接受以下字段：

字段	类型	说明
`getMore`	long	游标标识符。
`collection`	字符串	游标所操作的集合的名称。
`batchSize`	正整数	可选.每个批处理返回的最大文档数量。如果未设置 `batchSize`，则 `getMore` 为每个批处理返回最多 16 兆字 (MiB)。如果设置了 `batchSize`，则 `getMore` 返回 `batchSize` 个文档或 16 MiB 中较小的一个。
`maxTimeMS`	non-negative integer	可选。指定服务器在固定大小集合上等待与可追加游标查询匹配的新文档的时长。对于可追加 `awaitData` 游标，`getMore` 上的 `maxTimeMS` 相当于`maxAwaitTimeMS()`。驱动程序仅对固定大小集合上的可追加游标设置此值，其中 `awaitData` 为 `true`。否则，创建游标的命令会将 `maxTimeMS` 设置为初始操作和所有后续 `getMore` 操作的累积时间限制。对于将 `awaitData` 设置为 `true` 的可追加游标，以下情况成立：如果未提供值，则等待时间默认为 `1`（1000 毫秒）。 `maxTimeMS` 在 `getMore` 上指定 MongoDB 等待将新文档插入特定 `getMore` 命令的固定大小集合的最长时间。 `maxTimeMS` 由驱动程序为每次调用 `getMore` 单独设置。 MongoDB 使用与 `db.killOp()` 相同的机制终止超过时间限制的操作，但仅在指定的中断点处终止。在不可追加游标上调用 `getMore` 时，无法设置 `maxTimeMS`。相反，请在创建游标时使用 `maxTimeMS()` 进行设置。要在可追加游标上使用 `getMore` 和 `maxTimeMS`，请在使用 `cursor.tailable()` 创建游标时启用 `awaitData`。在创建游标的命令上设置 `maxTimeMS` 仅设置该操作的时间限制。使用 `getMore` 为进一步的操作设限。您可以为每次调用 `getMore` 而设置或者可以省略 `maxTimeMS`，并且不必使用相同的值。对于可追加游标，`getMore` 的超时会保留游标中发生超时之前累积的文档。对于不可追加游标，超时会引发错误。
`comment`	any	可选。用户提供的待附加到该命令的注释。设置后，该注释将与该命令的记录一起出现在以下位置： mongod 日志消息，位于 `attr.command.cursor.comment` 字段中。 `command.comment` 字段中的数据库分析器输出。 `currentOp` 输出，在 `command.comment` 字段。注释可以是任何有效的 BSON 类型（字符串、整型、对象、数组等）。如果省略，`getMore` 会继承在原始 `find` 或 `aggregate` 命令上设置的任何 `comment`。

输出

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

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

{
   "cursor" : {
      "id" : Long("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" : Long("6813467763969884181")
      }
   }
}

字段	说明
`cursor`	包含游标信息，包括游标 ID 和文档的 `nextBatch`。 If `find` (or subsequent `getMore` commands) returns partial results because the queried shard(s) aren't available, the find output includes a `partialResultsReturned` indicator field. If the queried shards are available for the initial `find` command, but one or more shards become unavailable for subsequent `getMore` commands, only the `getMore` commands that run while the shards aren't available include `partialResultsReturned` in their output. `postBatchResumeToken` 字段可以与 `$changeStream` 管道一起使用，从此处开始或恢复变更流。
`"ok"`	表明命令是成功（`1`）还是失败（`0`）。

字段

说明

cursor

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

If find (or subsequent getMore commands) returns partial results because the queried shard(s) aren't available, the find output includes a partialResultsReturned indicator field. If the queried shards are available for the initial find command, but one or more shards become unavailable for subsequent getMore commands, only the getMore commands that run while the shards aren't available include partialResultsReturned in their output.

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

"ok"

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

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

$clusterTime
operationTime

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

行为

访问控制

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

会话

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

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

事务

对于多文档事务：

For cursors created outside of a transaction, you cannot call getMore inside the transaction.
For cursors created in a transaction, you cannot call getMore outside the transaction.

慢查询

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

从MongoDB 8.0 开始，现有的 queryHash字段将复制到名为 planCacheShapeHash 的新字段中。如果您使用的是早期MongoDB版本，则只能看到 queryHash字段。未来的MongoDB版本将删除已弃用的 queryHash字段，您需要改用 planCacheShapeHash字段。

了解详情