Mongo.startSession()

定义¶

Mongo.startSession（<选项> ）¶

3.6版的新功能。

启动连接会话。该 mongo外壳分配会话ID与会话相关的命令。

该startSession()方法可以获取带有会话选项的文档。可用的选项有：

领域	描述
因果一致性	布尔值。启用或禁用会话的因果一致性。 默认Mongo.startSession()启用causalConsistency。 开始会话后，无法修改其 causalConsistency设置。 注意 即使Mongo连接对象可能禁用了因果一致性，会话也可能启用了因果一致性，反之亦然。要在连接对象上设置因果一致性，请参见 Mongo.setCausalConsistency()。
readConcern	文献。指定读取关注。 要在开始会话后修改设置，请参阅 Sessions.getOptions().setReadConcern()。
readPreference	文献。指定读取首选项。 readPreference文档包含该mode字段和可选tags字段： 复制 { mode: <string>, tags: <array> } 要在开始会话后修改设置，请参阅 Sessions.getOptions().setReadPreference()。
retryWrites	布尔值。启用或禁用在遇到瞬态网络错误时重试写入的功能。 如果mongo使用该--retryWrites选项启动外壳 ，retryWrites则默认情况下启用Mongo.startSession()。 开始会话后，无法修改其 retryWrites设置。
writeConcern	文献。指定写关注。 要在开始会话后修改设置，请参阅 Sessions.getOptions().setWriteConcern()。

例子¶

以下内容以因果一致性启动会话，并在Mongo与mongo外壳程序的全局db变量关联的连接对象上启用了可重试写入：

db = db.getMongo().startSession({retryWrites: true, causalConsistency: true}).getDatabase(db.getName());