- Reference >
mongo
Shell Methods >- Collection Methods >
- db.collection.copyTo()
db.collection.copyTo()¶
On this page
Definition¶
-
db.collection.
copyTo
(newCollection)¶ mongo
Shell MethodThis page documents the
mongo
shell method, and does not refer to the MongoDB Node.js driver (or any other driver) method. For corresponding MongoDB driver API, refer to your specific MongoDB driver documentation instead.Deprecated since version 3.0.
Important
Starting in version 4.2, MongoDB removes the
eval
command. The deprecateddb.collection.copyTo()
, which wraps theeval
command, can only be run against MongoDB 4.0 or earlier versions. For behavior and example, refer to the 4.0 or earlier version of the manual.Copies all documents from
collection
intonewCollection
using server-side JavaScript. IfnewCollection
does not exist, MongoDB creates it.Parameter Type Description newCollection
string The name of the collection to write data to. db.collection.copyTo()
returns the number of documents copied. If the copy fails, it throws an exception.