$isolated¶

On this page

Definition
Behavior
Example

Definition¶

$isolated¶

Prevents a write operation that affects multiple documents from yielding to other reads or writes once the first document is written. By using the $isolated option, you can ensure that no client sees the changes until the operation completes or errors out.

This behavior can significantly affect the concurrency of the system as the operation holds the write lock much longer than normal.

Behavior¶

The $isolated isolation operator does not provide “all-or-nothing” atomicity for write operations.

$isolated does not work with sharded clusters.

Example¶

Consider the following example:

copy

db.foo.update(
    { status : "A" , $isolated : 1 },
    { $inc : { count : 1 } },
    { multi: true }
)

Without the $isolated operator, the multi-update operation will allow other operations to interleave with its update of the matched documents.