diff --git a/source/includes/example-clone-collection-text.rst b/source/includes/example-clone-collection-text.rst new file mode 100644 index 00000000000..4ce0f05e3bb --- /dev/null +++ b/source/includes/example-clone-collection-text.rst @@ -0,0 +1,3 @@ +This operation copies the ``profiles`` collection from the ``users`` +database on the server at ``mongodb.example.net``. The operation only +copies documents that satisfy the query ``{ 'active' : true }``. \ No newline at end of file diff --git a/source/includes/example-clone-collection.rst b/source/includes/example-clone-collection.rst new file mode 100644 index 00000000000..595928bbb08 --- /dev/null +++ b/source/includes/example-clone-collection.rst @@ -0,0 +1,8 @@ +.. code-block:: javascript + + db.runCommand( { cloneCollection: "users.profiles", + from: "mongodb.example.net:27017", + query: { 'active' : true } + } ) + +.. include:: /includes/example-clone-collection-text.rst \ No newline at end of file diff --git a/source/includes/extracts-cloneCollection.yaml b/source/includes/extracts-cloneCollection.yaml index a50abaa6adc..99753665fdb 100644 --- a/source/includes/extracts-cloneCollection.yaml +++ b/source/includes/extracts-cloneCollection.yaml @@ -2,6 +2,9 @@ ref: _cloneCollection-behavior content: | :program:`mongos` does not support {{cloneCollection}}. + {{cloneCollection}} cannot be used if the `from` server has + :doc:`authorization ` enabled. + .. versionchanged:: 3.0 If the given :term:`namespace` already exists in the destination diff --git a/source/reference/command/cloneCollection.txt b/source/reference/command/cloneCollection.txt index 94b35f13fe8..82e5304f135 100644 --- a/source/reference/command/cloneCollection.txt +++ b/source/reference/command/cloneCollection.txt @@ -40,12 +40,4 @@ Behavior Example ------- -.. code-block:: javascript - - { cloneCollection: "users.profiles", - from: "mongodb.example.net:27017", - query: { active: true } } - -This operation copies the ``profiles`` collection from the ``users`` -database on the server at ``mongodb.example.net``. The operation only -copies documents that satisfy the query ``{ active: true }``. +.. include:: /includes/example-clone-collection.rst diff --git a/source/reference/method/db.cloneCollection.txt b/source/reference/method/db.cloneCollection.txt index b99f98235b2..e7715a1c45e 100644 --- a/source/reference/method/db.cloneCollection.txt +++ b/source/reference/method/db.cloneCollection.txt @@ -26,3 +26,13 @@ Behavior -------- .. include:: /includes/extracts/cloneCollection-behavior-method.rst + +Example +------- + +.. code-block:: javascript + + db.cloneCollection('mongodb.example.net:27017', 'users.profile', + { 'active' : true } ) + +.. include:: /includes/example-clone-collection-text.rst