Navigation
This version will reach end of life on Feb 2018. To upgrade, go to the Learn more about upgrading your version of MongoDB.

convertToCapped

On this page

convertToCapped

The convertToCapped command converts an existing, non-capped collection to a capped collection within the same database.

The command has the following syntax:

{ convertToCapped: <collection>, size: <capped size> }

convertToCapped takes an existing collection (<collection>) and transforms it into a capped collection with a maximum size in bytes, specified by the size argument (<capped size>).

During the conversion process, the convertToCapped command exhibits the following behavior:

  • MongoDB traverses the documents in the original collection in natural order and loads the documents into a new capped collection.
  • If the capped size specified for the capped collection is smaller than the size of the original uncapped collection, then MongoDB will overwrite documents in the capped collection based on insertion order, or first in, first out order.
  • Internally, to convert the collection, MongoDB uses the following procedure
    • cloneCollectionAsCapped command creates the capped collection and imports the data.
    • MongoDB drops the original collection.
    • renameCollection renames the new capped collection to the name of the original collection.

Note

MongoDB does not support the convertToCapped command in a sharded cluster.

Warning

The convertToCapped will not recreate indexes from the original collection on the new collection, other than the index on the _id field. If you need indexes on this collection you will need to create these indexes after the conversion is complete.

Example

Convert a Collection

The following example uses a db.collection.save() operation to create an events collection, and db.collection.stats() to obtain information about the collection:

db.events.save( { click: 'button-1', time: new Date() } )
db.events.stats()

MongoDB will return the following:

{
        "ns" : "test.events",
        ...
        "capped" : false,
        ...
}

To convert the events collection into a capped collection and view the updated collection information, run the following commands:

db.runCommand( { convertToCapped: 'events', size: 8192 } )
db.events.stats()

MongoDB will return the following:

{
     "ns" : "test.events",
     ...
     "capped" : true,
     "max" : NumberLong("9223372036854775807"),
     "maxSize" : 8192,
     ...
}

The convertToCapped will not recreate indexes from the original collection on the new collection, other than the index on the _id field. If you need indexes on this collection you will need to create these indexes after the conversion is complete.

See also

create