定义
- Mongo.startSession(<options>)
- 版本 3.6 中的新增功能。 - 为连接启动 会话。 - mongosh将会话ID分配给与会话关联的命令。- 重要- mongosh 方法- 本页面提供 - mongosh方法的相关信息。这不是数据库命令或特定语言驱动程序(例如 Node.js)的相关文档。- 有关数据库命令,请参阅 - startSession命令。- 如需了解 MongoDB API 驱动程序,请参阅特定语言的 MongoDB 驱动程序文档。 - 会话只能与创建会话的 - MongoClient对象一起使用。单个会话不能同时使用。使用单个会话的操作必须按顺序运行。- startSession()方法可以利用会话选项获取文档。可用的选项有:字段说明- 因果一致性(Causal Consistency) - 布尔值。 启用或禁用会话的因果一致性。 - Mongo.startSession()默认启用- causalConsistency。- 启动会话后,无法修改其 - causalConsistency设置。- 即使 - Mongo()连接对象禁用了因果一致性,会话仍可能启用了因果一致性,反之亦然。要设置连接对象的因果一致性,请参见- Mongo.setCausalConsistency()。- 事务外的 - 文档。指定读关注。 - 要在启动会话后修改设置,请参阅 - Session.getOptions().setReadConcern()。- readPreference - 文档。指定读取偏好。 - readPreference 文档包含 - mode字段和可选的- tags字段:- { mode: <string>, tags: <array> } - 要在启动会话后修改设置,请参阅 - Session.getOptions().setReadPreference()。- retryWrites - 布尔值。启用或禁用遇到瞬时网络错误时重试写入的功能。 - 如果使用 选项启动 - mongosh- --retryWrites,则默认下为- retryWrites- Mongo.startSession()启用 。- 启动会话后,无法修改其 - retryWrites设置。- writeConcern - 文档。指定写关注。 - 要在启动会话后修改设置,请参阅 - Session.getOptions().setWriteConcern()。
示例
以下示例在与Mongo() mongosh的全局db 变量关联的 连接对象上启动一个具有因果一致性和可重试写入功能的会话:
db = db.getMongo().startSession({retryWrites: true, causalConsistency: true}).getDatabase(db.getName());