Mongo.startSession()

Definição

Mongo.startSession(<options>)

Novidade na versão 3.6.

Inicia uma sessão para a conexão. mongosh atribui o ID da sessão aos comandos associados à sessão.

Importante

Método mongosh

Esta página documenta um método mongosh. Esta não é a documentação para comandos de banco de dados nem drivers específicos de linguagem, como Node.js.

Para o comando do banco de dados, consulte o comando startSession.

Para drivers de API do MongoDB, consulte a documentação do driver do MongoDB específica da linguagem.

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.

O método startSession() pode receber um documento com opções de sessão. As opções disponíveis são:

Campo	Descrição
causalConsistency	Boolean. Habilita ou desabilita a consistência causal da sessão. Mongo.startSession() habilita causalConsistency por padrão. Depois de iniciar uma sessão, não é possível modificar sua configuração causalConsistency. A sessão pode ter a consistência causal habilitada, embora o objeto de conexão Mongo() possa ter a consistência causal desabilitada ou vice-versa. Para definir a consistência causal no objeto de conexão, consulte Mongo.setCausalConsistency().
readConcern	Documento. Especifica a read concern. Para modificar a configuração após iniciar uma sessão, consulte Session.getOptions().setReadConcern().
readPreference	Documento. Especifica a read preference. O documento readPreference contém o campo mode e o campo opcional tags: { mode: <string>, tags: <array> } Para modificar a configuração após iniciar uma sessão, consulte Session.getOptions().setReadPreference().
retryWrites	Booleano. Habilita ou desabilita a capacidade de repetir as escritas ao encontrar erros transitórios de rede. Se você iniciar o mongosh --retryWrites com a retryWrites opção, o estará habilitado por Mongo.startSession()padrãopara. Depois de iniciar uma sessão, não é possível modificar sua configuração retryWrites.
writeConcern	Documento. Especifica a write concern. Para modificar a configuração após iniciar uma sessão, consulte Session.getOptions().setWriteConcern().

Exemplos

O exemplo a seguir inicia uma sessão com consistência causal e retryable writes habilitadas no objeto de conexão Mongo() associado à variável global db mongosh:

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