-
Notifications
You must be signed in to change notification settings - Fork 1.7k
/
Bulk.txt
72 lines (49 loc) · 1.92 KB
/
Bulk.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
======
Bulk()
======
.. default-domain:: mongodb
.. contents:: On this page
:local:
:backlinks: none
:depth: 1
:class: singlecol
Description
-----------
.. method:: Bulk()
.. versionadded:: 2.6
Bulk operations builder used to construct a list of write operations
to perform in bulk for a single collection. To instantiate the
builder, use either the
:method:`db.collection.initializeOrderedBulkOp()` or the
:method:`db.collection.initializeUnorderedBulkOp()` method.
Ordered and Unordered Bulk Operations
-------------------------------------
The builder can construct the list of operations as *ordered* or
*unordered*.
Ordered Operations
~~~~~~~~~~~~~~~~~~
With an *ordered* operations list, MongoDB executes the write
operations in the list serially. If an error occurs during the
processing of one of the write operations, MongoDB will return without
processing any remaining write operations in the list.
Use :method:`db.collection.initializeOrderedBulkOp()` to create a
builder for an ordered list of write commands.
.. include:: /includes/fact-bulk-operation-ordered-list.rst
.. include:: /includes/fact-bulk-operation-batches.rst
.. include:: /includes/fact-bulk-operation-sharded-cluster.rst
Unordered Operations
~~~~~~~~~~~~~~~~~~~~
With an *unordered* operations list, MongoDB can execute in parallel,
as well as in a nondeterministic order, the write operations in the
list. If an error occurs during the processing of one of the write
operations, MongoDB will continue to process remaining write operations
in the list.
Use :method:`db.collection.initializeUnorderedBulkOp()` to create a
builder for an unordered list of write commands.
.. include:: /includes/fact-bulk-operation-unordered-list.rst
.. include:: /includes/fact-bulk-operation-batches.rst
.. _bulk-methods:
Methods
-------
The :method:`Bulk()` builder has the following methods:
.. include:: /includes/toc/table-spec-bulk-methods.rst