startSession（数据库命令）

定义

startSession

The startSession command starts a new logical session for a sequence of operations.

提示

In mongosh, this command can also be run through the Mongo.startSession() helper method.

Helper methods are convenient for mongosh users, but they may not return the same level of information as database commands. In cases where the convenience is not needed or the additional return fields are required, use the database command.

兼容性

此命令可用于以下环境中托管的部署：

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

• MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本

• MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

该命令具有以下语法：

db.runCommand(
   {
     startSession: 1
   }
)

To run startSession, use the db.runCommand( { <command> } ) method.

db.runCommand(
   {
     startSession: 1
   }
)

行为

If the deployment enforces authentication/authorization, you must be authenticated to run the startSession command. The user who runs startSession owns the created session, and only that user can use the session.

如果部署不强制执行身份验证/授权，则创建的会话没有所有者，任何用户可以在任何连接上使用该会话。 如果用户对不强制执行身份验证/授权的部署进行身份验证并创建会话，则用户拥有该会话。 但是，任何连接上的任何用户都可以使用该会话。

如果部署在没有停机的情况下过渡到身份验证，则无法使用任何没有所有者的会话。

会话只能与创建会话的 MongoClient 对象一起使用。单个会话不能同时使用。使用单个会话的操作必须按顺序运行。

输出

In addition to the status and operation time of the command, the startSession returns the following session specific information:

id: { id: <UUID> }