Chapter about This Book License

true

});

db.hits.find();

22

---

Multiple Updates

The final surprise

update

has to offer is that, by default, it’ll update a single document. So far, for the examples we’ve

looked at, this might seem logical. However, if you executed something like:

db.unicorns.update({},

{$set: {vaccinated:

true

}});

db.unicorns.find({vaccinated:

true

});

You might expect to find all of your precious unicorns to be vaccinated. To get the behavior you desire, the

multi

option must be set to true:

db.unicorns.update({},

{$set: {vaccinated:

true

}},

{multi:

true

});

db.unicorns.find({vaccinated:

true

});

23

---

In This Chapter

This chapter concluded our introduction to the basic CRUD operations available against a collection. We looked at

update

in detail and observed three interesting behaviors. First, if you pass it a document without update operators,

MongoDB’s

update

will replace the existing document. Because of this, normally you will use the

$set

operator (or

one of the many other available operators that modify the document). Secondly,

update

supports an intuitive

upsert

option which is particularly useful when you don’t know if the document already exists. Finally, by default,

update

updates only the first matching document, so use the

multi

option when you want to update all matching documents.

24

---