Question

Basic problem

I have some large, but logically organised documents – and would like to perform updates on just a sub-section of an individual document.

Example

Given this simple document:

_id: 123456,
_rev: 3242342,
name: 'Stephen',
type: 'Person',
hobbies: [ 'sky-diving' ]

In my application I might have an addHobbies method, that would use a view that just retrieves:

_id: 123456,
_rev: 3242342,
hobbies: [ 'sky-diving' ]

So that it can then add an additional hobby to the hobbies array, and then PUT just this sub-set of data back to the document.

Question

As I understand it, CouchDB [1.2] does not allow partial updates like this, and so I believe it would be necessary to grab the whole document during the save operation, merge my changes, then PUT the whole document back on every single save.

• Is there another way of doing this (am I wrong about CouchDB’s capabilities)?
• Are there any libraries (I’m using express on node.js) to handle this kind of operation?

Answer 1

You are correct. That is, in fact, what document database means: check-outs and check-ins.

You can create (or use) shim code to simulate what you want, letting you focus on the important parts. On the server side, you can use update functions.

There are many solutions on the client side.

cradle.js will give you fake partials updates with the merge method.

If you only want to update one or more attributes, and leave the others untouched, you can use the merge() method:

db.merge('luke', {jedi: true}, function (err, res) {
    // Luke is now a jedi,
    // but remains on the dark side of the force.
});

https://github.com/cloudhead/cradle/

Related, and also for Node.js is Transaction for performing arbitrary atomic transactions on CouchDB documents.