cursor.addOption()

在此页面上

定义

cursor.addOption(flag)

本页介绍了 mongosh方法。这不是特定于语言的驱动程序（例如 Node.js）的文档。

对于 MongoDB API 驱动程序，请参阅特定语言的MongoDB 驱动程序文档。

从 v3.2 开始， mongo中已弃用cursor.addOption()操作符。请改用可用的游标方法。

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

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

范围	类型	说明
`flag`	标记	对于`mongosh` ，可以使用下面列出的游标标志。有关特定于驱动程序的列表，请参阅驱动程序文档。

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)

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