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()
方法具有以下参数:
标记
mongosh
提供了几个附加的游标标志来修改游标的行为。
标记 | 说明 |
---|---|
将游标设置为在收到最后一个数据后不关闭,从而允许查询继续返回在初始结果用完后添加的数据。 | |
允许查询从属副本。 | |
防止服务器空闲游标超时。 | |
与 DBQuery.Option.tailable 一起使用。将游标设置为在没有可用数据时阻塞查询线程,并在设定的时间内等待数据,而不是立即不返回数据。仅当超时时间已到时,游标才不返回数据。 | |
将游标设置为一次返回查询返回的所有数据,而不是将结果拆分为多个批处理。 | |
将游标设置为从针对分片集群的查询中返回部分数据,其中某些分片不响应而不是引发错误。 |
例子
以下示例添加了DBQuery.Option.tailable
标志和DBQuery.Option.awaitData
标志,以确保查询返回可追加游标。该序列创建一个游标。 返回完整结果集后,它会等待默认的 1000 毫秒间隔,以便捕获并返回查询期间添加的其他数据:
var t = db.myCappedCollection; var cursor = t.find().addOption(DBQuery.Option.tailable). addOption(DBQuery.Option.awaitData)
警告
添加不正确的传输协议标志可能会导致问题和/或额外的服务器负载。