Sessions & Transactions

A MongoDB client session. This class represents a logical session used for ordering sequential operations.

To create a client session, use startSession or withSession on a MongoClient.

If causalConsistency is not set to false when starting a session, read and write operations that use the session will be provided causal consistency guarantees depending on the read and write concerns used. Using “majority” read and write preferences will provide the full set of guarantees. See https://docs.mongodb.com/manual/core/read-isolation-consistency-recency/#sessions for more details.

e.g.

   let opts = MongoCollectionOptions(readConcern: .majority, writeConcern: .majority)
   let collection = database.collection("mycoll", options: opts)
   let futureCount = client.withSession { session in
       collection.insertOne(["x": 1], session: session).flatMap { _ in
           collection.countDocuments(session: session)
       }
   }

To disable causal consistency, set causalConsistency to false in the ClientSessionOptions passed in to either withSession or startSession.

See more

public final class ClientSession

Options to use when creating a ClientSession.

See more

public struct ClientSessionOptions

Options to use when starting a transaction.

See more

public struct TransactionOptions