This is a
mongoshmethod. This is not the documentation for
Node.jsor other programming language specific driver methods.
For the legacy
mongoshell documentation, refer to the documentation for the corresponding MongoDB Server release:
For MongoDB API drivers, refer to the language specific MongoDB driver documentation.
Used to change query behavior by setting the flags listed below.
cursor.addOption()method has the following parameter:
mongosh provides several additional cursor flags to
modify the behavior of the cursor.
Sets the cursor not to close once the last data is received, allowing the query to continue returning data added after the initial results were exhausted.
Allows querying of a replica slave.
Prevents the server from timing out idle cursors.
For use with
Sets the cursor to return all data returned by the query at once rather than splitting the results into batches.
Sets the cursor to return partial data from a query against a sharded cluster in which some shards do not respond rather than throwing an error.
The following example adds the
DBQuery.Option.tailable flag and the
DBQuery.Option.awaitData flag to ensure that the query returns a
tailable cursor. The sequence
creates a cursor. After returning the full result set, it waits for the
default interval of 1000 milliseconds so that it can capture
and return additional data added during the query:
var t = db.myCappedCollection; var cursor = t.find().addOption(DBQuery.Option.tailable). addOption(DBQuery.Option.awaitData)
Adding incorrect wire protocol flags can cause problems and/or extra server load.