MongoDB修改器
在mongodb中通常文档只会有一部分要更新,利用原子的更新修改器,可以做到只更新文档的一部分键值,而且更新极为高效,更新修改器是种特殊的键,用来指定复杂的更新操作,比如调整、增加、或者删除键,还可以操作数组和内嵌文档。增加、修改或删除键的时候,应该使用$修改器
1. $set修改器
$set修改器用来指定一个键值. 如果这个键不存在, 则创建它,它对于更新模式或者用户定义键来说很方便.
> db.users.findOne() { "_id" : ObjectId("56fe7df8b322e3ff1dabf834"), "name" : "joe", "age" : 30, "sex" : "male", "location" : "Wisconsin", "favorite book" : "war and pace" } > db.users.update({"name":"joe"},{"$set":{"favorite book":["cat's cardle","foundation trilogy","ender's game"]}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.users.findOne() { "_id" : ObjectId("56fe7df8b322e3ff1dabf834"), "name" : "joe", "age" : 30, "sex" : "male", "location" : "Wisconsin", "favorite book" : [ "cat's cardle", "foundation trilogy", "ender's game" ] }
2. $set用来修改内嵌文档
> db.blog.insert({"title":"a blog post","author":{"name":"joe","email":"joe@example.com"}}) WriteResult({ "nInserted" : 1 }) > db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post", "author" : { "name" : "joe", "email" : "joe@example.com" } } > db.blog.update({"author.name":"joe"},{"$set":{"author.name":"joe schmoe"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post", "author" : { "name" : "joe schmoe", "email" : "joe@example.com" } } > db.blog.update({"title":"a blog post"},{"$set":{"author.name":"joe schmoe op"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post", "author" : { "name" : "joe schmoe op", "email" : "joe@example.com" } }
3. $unset修改器
$unset修改用于将键删除
> db.users.findOne() { "_id" : ObjectId("56fe7df8b322e3ff1dabf834"), "name" : "joe", "age" : 30, "sex" : "male", "location" : "Wisconsin", "favorite book" : [ "cat's cardle", "foundation trilogy", "ender's game" ] } > db.users.update({"name":"joe"},{"$unset":{"favorite book":1}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.users.findOne() { "_id" : ObjectId("56fe7df8b322e3ff1dabf834"), "name" : "joe", "age" : 30, "sex" : "male", "location" : "Wisconsin" }
4. $inc修改器
$inc其用来增加或减少已有的键的键值,或者在键不存在的时候创建一个键。
> db.games.insert({"game":"pinball","user":"joe"}) WriteResult({ "nInserted" : 1 }) > db.games.findOne() { "_id" : ObjectId("5770a1394f533aa7535d46d4"), "game" : "pinball", "user" : "joe" } > db.games.update({"game":"pinball","user":"joe"},{"$inc":{"score":50}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.games.findOne() { "_id" : ObjectId("5770a1394f533aa7535d46d4"), "game" : "pinball", "user" : "joe", "score" : 50 }
为"score"键增加50再减少20
> db.games.update({"game":"pinball","user":"joe"},{"$inc":{"score":50}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.games.findOne() { "_id" : ObjectId("5770a1394f533aa7535d46d4"), "game" : "pinball", "user" : "joe", "score" : 100 } > db.games.update({"game":"pinball","user":"joe"},{"$inc":{"score":-20}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.games.findOne() { "_id" : ObjectId("5770a1394f533aa7535d46d4"), "game" : "pinball", "user" : "joe", "score" : 80 }
以上"$inc"与"$set"的用法类似,就是专门用来增加或减少数字的。"$inc"只能用于整数、长整数或双精度浮点数,要是在其他类型的数据上就会导致操作失败,其中包括很多语言会自动转换成数字的类型,例如null,布尔类型,或数字构成的字符串。"$inc"键的值必须为数字,不能使用字符串、数组和其他非数字的值,否则会报错,要修改其他类型,只能使用"$set"。
> db.foo.insert({"count":"1"}) WriteResult({ "nInserted" : 1 }) > db.foo.find() { "_id" : ObjectId("5770befc4f533aa7535d46d5"), "count" : "1" } > db.foo.update({},{"$inc":{"count":1}}) WriteResult({ "nMatched" : 0, "nUpserted" : 0, "nModified" : 0, "writeError" : { "code" : 16837, "errmsg" : "Cannot apply $inc to a value of non-numeric type. {_id: ObjectId('5770befc4f533aa7535d46d5')} has the field 'count' of non-numeric type String" } }) > db.foo.update({},{$set:{count:2}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.foo.find() { "_id" : ObjectId("5770befc4f533aa7535d46d5"), "count" : 2 } >
5. 数组修改器 $push
数组修改器,顾名思义它只可以用于操作数组,只能用在值为数组的键上。$push修改器如果指定的值已经存在,"$push"会想已有的数组末尾加入一个元素,要是没有就会创建一个新的数组
> db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post", "author" : { "name" : "joe schmoe op", "email" : "joe@example.com" } } > db.blog.update({"title":"a blog post"},{"$unset":{"author":1}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post" } > db.blog.update({"title":"a blog post"},{"$push":{"comments":{"name":"joe","email":"joe@example.com","content":"nice post"}}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post", "comments" : [ { "name" : "joe", "email" : "joe@example.com", "content" : "nice post" } ] }
6. 数组修改器 $ne
$ne也是用来操作数组的修改器,在查询文档中,如果一个值不在数组里面就把他加进去,如果在不添加
> db.users.insert({"name":"joe","emails":["joe@example.com","joe@gmail.com","joe@yahoo.com"]}) WriteResult({ "nInserted" : 1 }) > db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@example.com", "joe@gmail.com", "joe@yahoo.com" ] } > db.users.update({"name":"joe","emails":{$ne:"joe@gmail.com"}},{$push:{"emails":"joe@gmail.com"}}) WriteResult({ "nMatched" : 0, "nUpserted" : 0, "nModified" : 0 }) --nMatched为0表示没有修改 > db.users.update({"name":"joe","emails":{$ne:"joe@itpub.com"}},{$push:{"emails":"joe@itpub.com"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@example.com", "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com" ] }
以上这种方式也可以使用$addToSet实现。
7. 数组修改器 $addToSet
$addToSet也是用来操作数组的修改器,实现的功能与$ne修改器相同,且更为方便。使用$addToSet修改器可以避免重复
> db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@example.com", "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com" ] } > db.users.update({"_id":ObjectId("5770ca42e90c1adc80040a08")},{$addToSet:{"emails":"joe@gmail.com"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 0 }) --原文档里已有"joe@gmail.com",修改完也没有产生重复值 > db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@example.com", "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com" ] } > db.users.update({"_id":ObjectId("5770ca42e90c1adc80040a08")},{$addToSet:{"emails":"joe@163.com"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@example.com", "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com", "joe@163.com" ] }
8. 数组修改器 $each
$each数组修改器要和$addToSet修改结合起来用,可以一次添加多个不同的值。例如上面的例子中,我们一次添加多个email值, 如下:
> db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@example.com", "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com", "joe@163.com" ] } > db.users.update({"_id":ObjectId("5770ca42e90c1adc80040a08")},{$addToSet:{$each:["joe@example.com","joe@python.com","joe@php.com"]}}) WriteResult({ "nMatched" : 0, "nUpserted" : 0, "nModified" : 0, "writeError" : { "code" : 52, "errmsg" : "The dollar ($) prefixed field '$each' in '$each' is not valid for storage." } }) > db.users.update({"_id":ObjectId("5770ca42e90c1adc80040a08")},{$addToSet:{"emails":{$each:["joe@example.com","joe@python.com","joe@php.com"]}}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@example.com", "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com", "joe@163.com", "joe@python.com", "joe@php.com" ] }
9. 数组修改器 $pop
$pop修改器主要于从数组中删除元素,他可以从数组中的任何一端删除元素,
例如:
{$pop:{key:1}} 从数组末尾删除一个元素
{$pop:{key:-1}} 从数组头部删除一个元素
> db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@example.com", "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com", "joe@163.com", "joe@python.com", "joe@php.com" ] } > db.users.update({"name":"joe"},{$pop:{"emails":1}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@example.com", "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com", "joe@163.com", "joe@python.com" ] } > db.users.update({"name":"joe"},{$pop:{"emails":-1}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com", "joe@163.com", "joe@python.com" ] }
有时我们需要基于特定条件来删除元素,而不仅仅依据位置,就可以使用$pull修改器
10. 数组修改器 $pull
$pull修改器和$pop修改类似,都是用来删除数组中的元素
$pull可以基于特定条件来删除元素
$pull会将所有匹配到的数据全部删掉,如对数组[1,2,1,1]执行pull 1,得到的结果就是只有一个元素的数组[2]
例如我们想删除emails数组中的"joe@163.com"和"joe@itpub.com"两个元素:
> db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com", "joe@163.com", "joe@python.com" ] } > db.users.update({"name":"joe"},{$pull:{"emails":["joe@163.com","joe@itpub.com"]}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 0 }) --好像不能一次删除多个,没有起作用 > db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@gmail.com", "joe@yahoo.com", "joe@itpub.com", "joe@163.com", "joe@python.com" ] } > db.users.update({"name":"joe"},{$pull:{"emails":"joe@163.com"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.users.update({"name":"joe"},{$pull:{"emails":"joe@itpub.com"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.users.findOne() { "_id" : ObjectId("5770ca42e90c1adc80040a08"), "name" : "joe", "emails" : [ "joe@gmail.com", "joe@yahoo.com", "joe@python.com" ] }
11. 数组的定位修改器 $
若是数组有多个值,而我们只想对其中一部分进行操作,有两种方法可以实现这种操作。
两种方法操作数组中的值:通过位置或定位操作符("$")
数组都是以0开头的,可以将下标直接作为键来选择元素。
> db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post", "comments" : [ { "name" : "joe", "email" : "joe@example.com", "content" : "nice post" }, { "name" : "bob", "email" : "bob@example.com", "content" : "good post" } ] } > db.blog.update({"title":"a blog post"},{$set:{"comments.1.name":"livan"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post", "comments" : [ { "name" : "joe", "email" : "joe@example.com", "content" : "nice post" }, { "name" : "livan", "email" : "bob@example.com", "content" : "good post" } ] } > db.blog.update({"title":"a blog post"},{$set:{"comments.1.email":"livan@example.com"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post", "comments" : [ { "name" : "joe", "email" : "joe@example.com", "content" : "nice post" }, { "name" : "livan", "email" : "livan@example.com", "content" : "good post" } ] }
在很多情况下,不预先查询文档就不能知道要修改数组的下标,为了克服这种困难,mongodb提供了定位操作符"$",
用来定位查询文档已经匹配的元素,并进行更新,定位符只更新第一个匹配的元素。
例如:用户john把名字改成了jim,就可以用定位符来替换评论中的名字:
db.blog.update({"comments.author":"john"},{$set:{"comments.$.author:"john"}})
可以理解为{"comments.author":"john"}查询条件定位到第一个元素,就执行{$set: {"comments.$.author:"john"}},"$"定位符就表示找到的第一个元素
> db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post", "comments" : [ { "name" : "joe", "email" : "joe@example.com", "content" : "nice post" }, { "name" : "livan", "email" : "livan@example.com", "content" : "good post" } ] } > db.blog.update({"comments.name":"livan"},{$set:{"comments.$.email":"bob@example.com"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.blog.update({"comments.name":"livan"},{$set:{"comments.$.name":"bob"}}) WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) > db.blog.findOne() { "_id" : ObjectId("57709da84f533aa7535d46d3"), "title" : "a blog post", "comments" : [ { "name" : "joe", "email" : "joe@example.com", "content" : "nice post" }, { "name" : "bob", "email" : "bob@example.com", "content" : "good post" } ] }