cursor.addOption()

在此页面上

定义

cursor.addOption(flag)

本页面提供 mongosh 方法的相关信息。这不是特定于语言的驱动程序（例如 Node.js）的文档。

如需了解 MongoDB API 驱动程序，请参阅特定语言的 MongoDB 驱动程序文档。

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

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

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)

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

后退

游标

来年

cursor.allowDiskUse