$isolated¶

$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.

Note

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

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.

Warning

$isolated does not work with sharded clusters.