MongoDB Tip: The touch Command

< View all blog posts

March 06, 2013
Category: Release Notes

MongoDB 2.2 introduced the touch command, which loads data from the data storage layer into memory. The touch command will load a collection’s documents, indexes or both into memory. This can be ideal to preheat a newly started server, in order to avoid page faults and slow performance once the server is brought into production. You can also use this when adding a new secondary to an existing replica set to ensure speedy subsequent reads.

Note that while the touch command is running, a replica set member will enter into a RECOVERING state to prevent reads from clients. When the operation completes, the secondary will return to the SECONDARY(2) state.

You invoke the touch command through the following syntax:

db.runcommand({ touch: “collection_name”, data: true, index: true})

Here you indicate which collection to touch and whether or not you want both documents (data) and/or indexes to be loaded into memory. Index and data are both off by default, so you will need to indicate at least one as “true” to have any effect on your server. Otherwise you will see the following message:


"ok" : 0,
"errmsg" : "must specify at least one of (data:true, index:true)

touch is non-blocking on a mongod process, so you can run it concurrent with other commands.

For a full list of MongoDB commands, check out the Database commands in the MongoDB Manual

comments powered by Disqus