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());