Skip to content

Commit 2391da0

Browse files
authored
DOCSP-38679 mongoexport consistency consideration (#166)
* DOCSP-38679 mongoexport consistency consideration * DOCSP-38679 mongoexport consistency consideration * DOCSP-38679 copy edit * DOCSP-38679 tech edits: * DOCSP-38679 tech edits: * DOCSP-38679 tech edits:
1 parent 7fd0f9c commit 2391da0

File tree

2 files changed

+27
-0
lines changed

2 files changed

+27
-0
lines changed

source/mongodump.txt

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -224,6 +224,18 @@ Syntax
224224
.. tab:: Connect to a Sharded Cluster
225225
:tabid: connect-to-a-sharded-cluster
226226

227+
.. note::
228+
229+
To avoid data inconsistencies, pause the following actions on your
230+
sharded cluster when you run ``mongodump``:
231+
232+
- Cross-shard transactions
233+
- Data definition language operations (operations that create and modify
234+
collections)
235+
- Chunk balancing
236+
237+
To stop the balancer, use the :method:`sh.stopBalancer()` method.
238+
227239
To connect to a sharded cluster to export its data, you can:
228240

229241
- Specify the hostname of the ``mongos`` instance in the

source/mongoexport.txt

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,9 @@ or CSV export of data stored in a MongoDB instance.
3939
Run ``mongoexport`` from the system command line, not the
4040
:binary:`~bin.mongo` shell.
4141

42+
``mongoexport`` is not a tool for backing up deployments. If you want to
43+
create a backup solution, see :ref:`manual-tutorial-backup-and-restore`.
44+
4245
.. seealso::
4346

4447
:binary:`~bin.mongoimport` which provides the corresponding
@@ -171,6 +174,18 @@ For more information on the options available, see :ref:`mongoexport-options`.
171174
Connect to a Sharded Cluster
172175
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
173176

177+
.. note::
178+
179+
To avoid data inconsistencies, pause the following actions on your
180+
sharded cluster when you run ``mongoexport``:
181+
182+
- Cross-shard transactions
183+
- Data definition language operations (operations that create and modify
184+
collections)
185+
- Chunk balancing
186+
187+
To stop the balancer, use the :method:`sh.stopBalancer()` method.
188+
174189
To connect to a sharded cluster to export its data, you can either:
175190

176191
- Specify the hostname of the :binary:`~bin.mongos` instance in the

0 commit comments

Comments
 (0)