Versions 3.6 and higher of the MongoDB server support sessions. You can use sessions with Mongoid in a similar way
that you would execute a transaction in ActiveRecord. Namely, you can call a method,
#with_session on a model class
or on an instance of a model and execute some operations in a block. All operations in the block will be
executed in the context of single session. Please see the MongoDB Ruby driver documentation for what session options
Please note the following limitations of sessions:
Sessions cannot be shared across threads; sessions are not thread-safe. This is consistent with the Ruby driver's support for sessions.
Sessions cannot be nested. You cannot called
#with_sessionon a model class or a model instance within the block passed to the
#with_sessionmethod on another model class or model instance.
All model classes and instances used within the session block must use the same driver client. For example, if you have specified different
storage_optionsfor another model used in the block than that of the model class or instance on which
#with_sessionis called, you will get an error.
All connected MongoDB servers must be version 3.6 or higher.
Using a Session via Model#with_session
#with_session on a model class and pass it session options to execute a block in the context
of a session.
Person.with_session(causal_consistency: true) do Person.create! person = Person.first person.name = "Emily" person.save end
Using a Session via model#with_session
#with_session on a model instance and pass it session options to execute a block in the context
of a session.
person.with_session(causal_consistency: true) do person.username = 'Emily' person.save person.posts << Post.create! end