MongoDB\Driver\Session::commitTransaction
(mongodb >=1.5.0)
MongoDB\Driver\Session::commitTransaction — Confirma uma transação
Descrição
Salva as alterações feitas pelas operações na transação multidocumento e finaliza a transação. Até a confirmação, nenhuma das alterações de dados feitas dentro da transação será visível fora da transação.
Parâmetros
Esta função não possui parâmetros.
Valor Retornado
Nenhum valor é retornado.
Erros/Exceções
- Lança uma exceção MongoDB\Driver\Exception\InvalidArgumentException em caso de erro ao analisar argumentos.
- Lança uma
MongoDB\Driver\Exception\CommandException se o
servidor não conseguiu confirmar a transação (por exemplo, devido a conflitos, problemas
de rede). Caso o
MongoDB\Driver\Exception\CommandException::getResultDocument() da exceção
tenha um elemento
"errorLabels"e este array contenha um valor"TransientTransactionError"ou"UnknownTransactionCommitResult", é seguro tentar novamente a transação inteira. Em versões mais recentes da extensão, MongoDB\Driver\Exception\RuntimeException::hasErrorLabel() deve ser usado para testar esta situação. - Lança uma MongoDB\Driver\Exception\RuntimeException se a transação não puder ser confirmada (por exemplo, uma transação não foi iniciada).
Veja Também
- MongoDB\Driver\Manager::startSession() - Inicia uma nova sessão de cliente para uso com este cliente
- MongoDB\Driver\Session::abortTransaction() - Aborta uma transação
- MongoDB\Driver\Session::startTransaction() - Inicia uma transação
- MongoDB\Driver\Exception\RuntimeException::hasErrorLabel() - Retorna se um rótulo de erro está associado a uma exceção