SessionOptions
On this page
Definition
SessionOptions
The options for a
session
inmongosh
. To access theSessionOptions()
object, use theSession.getOptions()
method.The session options available are:
OptionDescriptioncausalConsistency
Boolean. Enables or disables causal consistency for the session.
You can explicitly set the option when you start a session manually:
Session = db.getMongo().startSession( { causalConsistency: true } )
readConcern
Document. Specifies the read concern.
In
mongosh
, you can set the option when you runMongo.startSession()
. You can also access thereadConcern
option via the following methods:Session.getOptions().getReadConcern()
Session.getOptions().setReadConcern(<document>)
readPreference
Document. Specifies the read preference.
In
mongosh
, you can set the option when you runMongo.startSession()
. You can also access thereadPreference
option via the following methods:Session.getOptions().getReadPreference()
Session.getOptions().setReadPreference({ mode: <string>, tags: <array>})
retryWrites
Boolean. Enables or disables the ability to retry writes upon encountering transient network errors, such as during failovers.
To enable retry writes, start
mongosh
with the--retryWrites
option.You can view whether
retryWrites
is enabled for a session via the following method:Session.getOptions().shouldRetryWrites()
writeConcern
Document. Specifies the write concern.
In
mongosh
, you can set the options when you runMongo.startSession()
. You can also access thewriteConcern
option via the following methods:Session.getOptions().getWriteConcern()
Session.getOptions().setWriteConcern(<document>)
Verify which options are enabled for the session by running
Session.getOptions()
.