Mongo.startSession()

Definição

Mongo.startSession(<options>)

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 ou drivers específicos de idioma, 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 MongoDB específica do idioma.

Para a documentação de shell legada do mongo, consulte a documentação para a versão correspondente do MongoDB Server:

mongo shell v4.4

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. Mutualmente exclusivo com snapshot. Depois de iniciar uma sessão, não é possível modificar sua configuração causalConsistency. Observação 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 com a opção --retryWrites , retryWrites estará habilitado por padrão para Mongo.startSession(). Depois de iniciar uma sessão, não é possível modificar sua configuração retryWrites.
snapshot	Boolean. Habilita leituras de snapshot para a sessão do MongoDB 5.0+ sistemas. Mutualmente exclusivo com causalConsistency.
Escreva preocupação	Documento. Especifica a write concern. Para modificar a configuração após iniciar uma sessão, consulte Session.getOptions().setWriteConcern().

Compatibilidade

Este método está disponível em sistemas hospedados nos seguintes ambientes:

• MongoDB Atlas: o serviço totalmente gerenciado para implantações MongoDB na nuvem

• MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

• MongoDB Community: uma versão código-disponível, de uso gratuito e autogerenciada do MongoDB

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());