cursor.addOption（）_MonogDB 中文网

在本页面

定义¶

cursor.addOption（标志）¶

mongo 壳法

此页面记录了mongoshell方法，并且没有引用MongoDB Node.js驱动程序（或任何其他驱动程序）方法。对于相应的MongoDB驱动程序API，请改为参考您特定的 MongoDB驱动程序文档。

从v3.2开始不推荐使用

从v3.2开始，shell中cursor.addOption()不推荐使用该运算符 mongo。在mongo外壳中，改用可用的游标方法。

添加OP_QUERY有线协议标志，例如tailable 标志，以更改查询的行为。

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

参数	类型	描述
`flag`	旗	`OP_QUERY`有线协议标志。对于`mongo`外壳，可以使用下面列出的光标标志。有关特定于驱动程序的列表，请参见驱动程序文档。

该mongo外壳提供了一些额外的光标标志修改游标的行为。

旗	描述
`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标志，以确保查询返回可尾光标。该序列创建一个游标，该游标将在返回完整结果集后等待几秒钟，以便它可以捕获并返回在查询期间添加的其他数据：

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

警告

添加错误的有线协议标志可能会导致问题和/或增加服务器负载。