Join us Sept 17 at .local NYC! Use code WEB50 to save 50% on tickets. Learn more >
MongoDB Event
Docs 菜单
Docs 主页
/
MongoDB Manual
/ / /

cursor.addOption()

cursor.addOption(flag)

重要

mongosh 方法

这是一个mongosh方法。 这不是Node.js或其他特定于编程语言的驱动程序方法的文档。

在大多数情况下, mongosh方法的工作方式与传统 mongo shell方法相同。 但是,某些旧方法在mongosh中不可用。

有关旧版mongo shell 文档,请参阅相应 MongoDB Server 版本的文档:

有关 MongoDB API 驱动程序,请参阅特定语言的 MongoDB 驱动程序文档。

注意

自 v3.2 起已弃用

从 v 3.2开始, cursor.addOption()操作符在mongosh中已弃用。 在mongosh中,请改用可用的游标方法

用于通过设置下面列出的标志来更改查询行为。

cursor.addOption()方法具有以下参数:

Parameter
类型
说明

flag

flag

OP_QUERY 传输协议标志。 对于mongosh ,可以使用下面列出的游标标志。 有关特定于驱动程序的列表,请参阅驾驶员文档。

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

重要

此命令在 M 0 、 M 2 、 M 5和 M 10 + 集群中提供有限支持。 有关更多信息,请参阅不支持的命令。

mongosh 提供了几个附加的游标标志来修改游标的行为。

标记
说明
DBQuery.Option.tailable

将游标设置为在收到最后一个数据后不关闭,从而允许查询继续返回在初始结果用完后添加的数据。

DBQuery.Option.slaveOk

允许查询从属副本。

DBQuery.Option.noTimeout

防止服务器空闲游标超时。

DBQuery.Option.awaitData

DBQuery.Option.tailable与 一起使用。将游标设置为在没有可用数据时区块查询线程,并在设立的时间内等待数据,而不是立即不返回数据。 仅当超时时间已到时,游标才不返回数据。

DBQuery.Option.exhaust

将游标设置为一次返回查询返回的所有数据,而不是将结果拆分为多个批处理。

DBQuery.Option.partial

将游标设置为从针对分片集群的查询中返回部分数据,其中某些分片不响应而不是引发错误。

以下示例添加了DBQuery.Option.tailable标志和DBQuery.Option.awaitData标志,以确保查询返回可追加游标。该序列创建一个游标。 返回完整结果集后,它会等待默认的 1000 毫秒间隔,以便捕获并返回查询期间添加的其他数据:

var t = db.myCappedCollection;
var cursor = t.find().addOption(DBQuery.Option.tailable).
addOption(DBQuery.Option.awaitData)

警告

添加不正确的传输协议标志可能会导致问题和/或额外的服务器负载。

后退

Cursors

在此页面上