startSession

Definição

startSession

O comando startSession inicia uma nova sessão lógica para uma sequência de operações.

Dica

Em mongosh, esse comando também pode ser executado por meio do método auxiliar Mongo.startSession() .

Os métodos auxiliares são convenientes para os usuários mongosh , mas podem não retornar o mesmo nível de informações que os comandos do banco de dados. Nos casos em que a conveniência não for necessária ou os campos de retorno adicionais forem necessários, use o comando de banco de dados.

Sintaxe

O comando tem a seguinte sintaxe:

db.runCommand(
   {
     startSession: 1
   }
)

Para executar startSession, use o método db.runCommand( { <command> } ) .

db.runCommand(
   {
     startSession: 1
   }
)

Comportamento

Se o sistema impuser autenticação/autorização, você deverá estar autenticado para executar o comando startSession . O usuário que executa startSession é proprietário da sessão criada e somente esse usuário pode usar a sessão.

Se a implantação não impor autenticação/autorização, uma sessão criada não terá proprietário e poderá ser usada por qualquer usuário em qualquer conexão. Se o usuário autenticar e criar uma sessão para uma implantação que não imponha autenticação/autorização, ele será o proprietário da sessão. No entanto, qualquer usuário em qualquer conexão pode usar a sessão.

Se a implantação fizer a transição para a autenticação sem nenhum tempo de inatividade, as sessões sem proprietário não poderão ser usadas.

Uma sessão só pode ser usada com o objeto MongoClient que criou a sessão. Uma única sessão não pode ser usada simultaneamente. As operações que usam uma única sessão devem ser executadas sequencialmente.

Saída

Além do status e do tempo de operação do comando, o startSession retorna as seguintes informações específicas da sessão:

id: { id: <UUID> }