(mongodb >=1.4.0)
MongoDB\Driver\Manager::startSession — Inicia uma nova sessão de cliente para uso com este cliente
Cria um objeto MongoDB\Driver\Session para as opções fornecidas. A sessão pode então ser especificada ao executar comandos, consultas e operações de gravação.
Nota: Um MongoDB\Driver\Session só pode ser usado com o MongoDB\Driver\Manager a partir do qual foi criado.
options
| Opção | Tipo | Descrição | Default | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| causalConsistency | bool |
Configura a consistência causal em uma sessão. Se true, cada operação
na sessão será ordenada causalmente após a operação anterior de leitura ou
gravação. Se definido como false, desativa a consistência causal.
Consulte
» Consistência Causal
no manual do MongoDB para obter mais informações.
|
true |
|||||||||||||||
| defaultTransactionOptions | array |
Opções padrão a serem aplicadas a transações recém-criadas. Estas
opções são utilizadas a menos que sejam substituídas quando uma transação é
iniciada com valores diferentes para cada opção.
|
[] |
|||||||||||||||
| snapshot | bool |
Configure leituras de instantâneos em uma sessão. Se true, um timestamp
será obtido da primeira operação de leitura suportada na sessão
(ou seja, find, aggregate ou
distinct não fragmentado). As operações de leitura
subsequentes dentro da sessão utilizarão um nível de preocupação de leitura
"snapshot" (instantâneo) para ler os dados confirmados pela maioria daquele
timestamp. Se definido como false, desativa leituras de instantâneos.
As leituras de instantâneo requerem MongoDB 5.0+ e não podem ser usadas
com consistência causal, transações ou operações de gravação. Se
"snapshot" for true,
"causalConsistency" será padronizado como false.
Consulte
» Preocupação de Leitura "snapshot"
no manual do MongoDB para obter mais informações.
|
false |
Retorna um MongoDB\Driver\Session.
"causalConsistency" e "snapshot" forem ambas true.| Versão | Descrição |
|---|---|
| PECL mongodb 1.11.0 |
A opção "snapshot" foi adicionada.
|
| PECL mongodb 1.6.0 |
A opção "maxCommitTimeMS" foi adicionada a
"defaultTransactionOptions".
|
| PECL mongodb 1.5.0 |
A opção "defaultTransactionOptions" foi adicionada.
|