DOCSP 37692 recommendation for mongodump and mongorestore (#133)

ltran-mdb2 · web-flow · commit d077ce1044ff · 2024-03-28T11:24:54.000-04:00
* DOCSP-37692 adding recommended use cases * DOCSP-37692 adding recommended use cases * DOCSP-37692 tech edit * DOCSP-37692 tech edit * DOCSP-37692 tech edit
diff --git a/source/includes/fact-mongodump-mongorestore-use-cases.rst b/source/includes/fact-mongodump-mongorestore-use-cases.rst
@@ -0,0 +1,8 @@
+:binary:`~bin.mongoimport` and :binary:`~bin.mongoexport` are not
+intended for the following use cases:
+
+- backing up and restoring data
+- converting data on a MongoDB cluster to a different format (for
+  example, converting to JSON) and then back to a MongoDB cluster.
+
+Instead, use :binary:`~bin.mongodump` or :binary:`~bin.mongorestore`. 
diff --git a/source/mongoexport.txt b/source/mongoexport.txt
@@ -51,6 +51,10 @@ or CSV export of data stored in a MongoDB instance.
 
 .. include:: /includes/fact-migrate-atlas.rst
 
+.. note::
+
+   .. include:: /includes/fact-mongodump-mongorestore-use-cases.rst
+
 Versioning
 ~~~~~~~~~~
 
diff --git a/source/mongoimport.txt b/source/mongoimport.txt
@@ -47,6 +47,10 @@ tool.
 
 .. include:: /includes/fact-migrate-atlas.rst
 
+.. note::
+
+   .. include:: /includes/fact-mongodump-mongorestore-use-cases.rst
+
 Versioning
 ~~~~~~~~~~
 
