MongoDB\Driver\Manager::startSession

(mongodb >=1.4.0)

MongoDB\Driver\Manager::startSession — Start a new client session for use with this client

Descrierea

final public MongoDB\Driver\Manager::startSession ([ array $options ] ) : MongoDB\Driver\Session

Creates a MongoDB\Driver\Session for the given options. The session may then be specified when executing commands, queries, and write operations.

Notă: A MongoDB\Driver\Session can only be used with the MongoDB\Driver\Manager from which it was created.

Parametri

options

Option Type Description Default

causalConsistency

bool

Configure causal consistency in a session. If true, each operation in the session will be causally ordered after the previous read or write operation. Set to false to disable causal consistency.

See » Casual Consistency in the MongoDB manual for more information.

true

defaultTransactionOptions

array

Default options to apply to newly created transactions. These options are used unless they are overridden when a transaction is started with different value for each option.

**options**
Option	Type	Description
maxCommitTimeMS	integer	Timpul maxim în milisecunde permis pentru rularea comenzii `commitTransaction`. Dacă este specificat, `maxCommitTimeMS` trebuie să fie un întreg pe 32 de biți mai mare sau egal cu zero.
readConcern	MongoDB\Driver\ReadConcern	O preocupare de citire pentru a fi aplicată operațiunii. Această opțiune este disponibilă în MongoDB 3.2+ și va rezulta într-o excepție în timpul execuției dacă e specificată pentru o versiune mai veche a serverului.
readPreference	MongoDB\Driver\ReadPreference	Preferința de citire pentru a fi folosită la selectarea serverului pentru operațiune.
writeConcern	MongoDB\Driver\WriteConcern	O preocupare de înscriere pentru a fi aplicată operațiunii.

This option is available in MongoDB 4.0+.

[]

Valorile întoarse

Returns a MongoDB\Driver\Session.

Erori/Excepții

Emite MongoDB\Driver\Exception\InvalidArgumentException în cazul erorilor la interpretarea argumentelor.
Throws MongoDB\Driver\Exception\RuntimeException if the session could not be created (e.g. libmongoc does not support crypto).

Istoricul schimbărilor

Versiune	Descriere
PECL mongodb 1.6.0	The `"maxCommitTimeMS"` option was added to `"defaultTransactionOptions"`.
PECL mongodb 1.5.0	The `"defaultTransactionOptions"` option was added.

A se vedea și

MongoDB\Driver\Session
» Casual Consistency in the MongoDB manual

add a note

User Contributed Notes

There are no user contributed notes for this page.