Sessão

Definição

Session

Novidade na versão 3.6.

O objeto Sessão para a conexão em mongosh. Para instanciar uma sessão para a conexão no mongosh, consulte Mongo.startSession(). Para obter mais informações sobre sessões,consulte Sessões de cliente e garantias de consistência causal.

Métodos gerais de sessão

Método	Descrição
Session.advanceClusterTime()	Atualiza o tempo de agrupamento monitorado pela sessão. Este método tem os seguintes parâmetros: Session.advanceClusterTime( { clusterTime: <timestamp>, signature: { hash: <BinData>, keyId: <NumberLong> } } )
Session.advanceOperationTime(<timestamp>)	Atualiza o tempo de operação.
Session.endSession()	Termina a sessão.
Session.getClusterTime()	Retorna o horário mais recente do cluster, conforme visto pela sessão. Aplicável apenas para conjuntos de réplica e clusters fragmentados.
Session.getDatabase(<database>)	Acesse o banco de dados especificado da sessão em mongosh.
Session.getOptions()	Acesse as opções da sessão. Para as opções disponíveis, consulte SessionOptions().
Session.getOperationTime()	Gera o registro de data/hora da última operação reconhecida para a sessão.
Session.hasEnded()	Gera um boolean que especifica se a sessão terminou.

Métodos de sessão para transações

Método	Descrição
Session.abortTransaction()	Cancela a transação da sessão. Para detalhes, consulte Session.abortTransaction().
Session.commitTransaction()	Compromete a transação da sessão. Para detalhes, consulte Session.commitTransaction().
Session.startTransaction()	Inicia uma transação de vários documentos para a sessão. Para detalhes, consulte Session.startTransaction().
Session.withTransaction()	Executa uma função lambda especificada dentro de uma transação. Para detalhes, consulte Session.withTransaction().

Exemplo

O exemplo a seguir inicia uma sessão no objeto de conexão Mongo() associado à variável global db de mongosh e, em seguida, usa o método Session.getDatabase() para recuperar o objeto de banco de dados associado à sessão.

var session = db.getMongo().startSession();
db = session.getDatabase(db.getName());