Mongo.startSession()
在本页面
Definition
Mongo.
startSession
(* *)- 3.6 版的新功能。
启动一个session进行连接。 mongo Shell 将会话 ID 分配给与该会话关联的命令。
startSession()方法可以获取带有会话选项的文档。可用的选项有:
Field | Description |
---|---|
causalConsistency | 布尔值。为会话启用或禁用causal consistency。 Mongo.startSession()默认启用causalConsistency 。 |
开始会话后,您无法修改其causalConsistency
设置。
Note
即使Mongo连接对象可能已禁用因果一致性,会话也可能启用了因果一致性,反之亦然。要在连接对象上设置因果一致性,请参见Mongo.setCausalConsistency()。
|
| readConcern |文档。指定read concern。
> 要在开始会话后修改设置,请参阅Sessions.getOptions().setReadConcern()
。
| readPreference |文档。指定read preference。
> readPreference 文档包含mode
字段和可选的tags
字段:
> { mode: <string>, tags: <array> }
> 要在开始会话后修改设置,请参阅Sessions.getOptions().setReadPreference()
。
| retryWrites |布尔值。启用或禁用在遇到瞬时网络错误时重试写入的功能。
> 如果使用--retryWrites选项启动mongo shell,则默认情况下Mongo.startSession()启用retryWrites
。
> 开始会话后,您无法修改其retryWrites
设置。
| writeConcern |文档。指定write concern。
> 要在开始会话后修改设置,请参阅Sessions.getOptions().setWriteConcern()
。
Examples
以下内容以因果一致性启动会话,并在与mongo shell 的全局db
变量关联的Mongo连接对象上启用了可重试写入:
db = db.getMongo().startSession({retryWrites: true, causalConsistency: true}).getDatabase(db.getName());