MongoDB 文档字段增删改

分手后的思念是犯贱 2022-07-12 03:14 217阅读 0赞

> MongoDB 基于CRUD(create，read，update，delete)方式实现了对集合上的文档进行增删改查。对于集合上字段的增删改，可以使用set或者unset修改器来实现。也可以使用文档替换的方式来实现。本文主要描述集合上字段的增删改，以及基于选项upsert的更新。

关于MongoDB文档更新可以参考：[MongoDB 文档更新][MongoDB]

## 一、语法描述 ##

db.collection.update(
           <query>,                  //查询或过滤条件
           <update>,                 //修改器(被修改键及内容)
           {                         
             upsert: <boolean>,      //为true或者false，如果为true，未找到匹配文档则创建新文档
             multi: <boolean>,       //用于确定是单行还是更新所有行(true为所有行)
             writeConcern: <document>   //设定写关注，用于确保强一致性还是弱一致性
           }                            //后面的3.2之后的语法参数基本相同
        )
    
        其他的如updateOne，updateMany等用法请参考：MongoDB 文档更新
    
        MongoDB集合上所有的写操作特性
                原子性操作(单个文档级别原子性操作)
                _id 字段无法修改，即无法使用一个新的_id值来代替
                由于更新导致文档尺寸超出预期分配的情形，会自动调整填充因子，重新分配空间
                保留文档字段的顺序，但是更新或重命名可能导致字段顺序重新排序(_id总是文档第一个字段)

## 二、update的几个常用修改器 ##

### 1、文档更新($set修改器常规更新) ###

//$set修改器最常用，等同于RDBMS update的set子句  
//演示重用的的示例集合数据请参考：[mongoDB 比较运算符][mongoDB]

> db.persons.find().limit(1).pretty()
    {
            "_id" : ObjectId("5864d8d435ac4f57fb2528f8"),
            "name" : "robinson.cheng",
            "age" : 25,
            "email" : "robinson.cheng@qq.com",
            "score" : {
                    "c" : 89,
                    "m" : 96,
                    "e" : 87
            },
            "country" : "USA",
            "books" : [
                    "JS",
                    "C++",
                    "EXTJS",
                    "MONGODB"
            ],
            "blog" : "http://blog.csdn.net/leshami"
    }
    > 
    > //使用$set修改器修改age字段
    > db.persons.update({name:"robinson.cheng"},{$set:{age:24}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    > //使用$set修改器修改嵌套文档，使用成员.方式来实现
    
    > db.persons.update({name:"robinson.cheng"},{$set:{
       "score.c":92}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    > //查看修改后的结果
    > db.persons.find({name:"robinson.cheng"},{
       "_id":0,name:1,age:1,score:1}).pretty()
    {
            "name" : "robinson.cheng",
            "age" : 24,
            "score" : {
                    "c" : 92,
                    "m" : 96,
                    "e" : 87
            }
    }

### 2、将文档普通字段转换为数组($set) ###

//如下，将country设定为数组
    > db.persons.update({name:"robinson.cheng"},{$set:{country:["USA","CN","HK"]}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    > db.persons.find({name:"robinson.cheng"},{
       "_id":0,name:1,country:1})
    { "name" : "robinson.cheng", "country" : [ "USA", "CN", "HK" ] }

### 3、文档新增字段($set实现) ###

//下面使用$set文档新增一个add字段，也可以使用$inc实现新增字段(见后面的描述)
    > db.persons.update({name:"robinson.cheng"},{$set:{
       add:"ShenZhen"}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    > //查看新增字段add
    > db.persons.find({name:"robinson.cheng"},{
       "_id":0,name:1,age:1,add:1})
    { "name" : "robinson.cheng", "age" : 24, "add" : "ShenZhen" }

### 4、文档删除字段 ###

//注，字段的删除方法为{
       "$unset":{field_name:1}}
    
    > db.persons.update({name:"robinson.cheng"},{
       "$unset":{
       add:1}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    //验证删除后的结果add未显示
    > db.persons.find({name:"robinson.cheng"},{
       "_id":0,name:1,age:1,add:1})
    { "name" : "robinson.cheng", "age" : 24 }

### 5、字段值的增加或减少 ###

//当使用$inc修改器时，当字段不存在时，会自动创建该字段，如果存在，则在原有值的基础上进行增加或者减少
    //$inc主要是用于专门进行数字的增加或减少，因此$inc只能用于整型，长整形，或者双精度浮点型的值
    //$inc不支持字符串，数组以及其他非数字的值
    //注，对于$inc的操作，$set也可以完成。$inc存在的理由是$inc更高效
    
    //下面通过$inc新增salary字段
    > db.persons.update({name:"robinson.cheng"},{$inc:{salary:1000}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    > db.persons.find({name:"robinson.cheng"},{
       "_id":0,name:1,salary:1}).pretty()
    { "name" : "robinson.cheng", "salary" : 1000 }
    
    //再次执行$inc
    > db.persons.update({name:"robinson.cheng"},{$inc:{salary:2000}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    //查询结果为在原有1000的基础上增加2000，即为3000
    > db.persons.find({name:"robinson.cheng"},{
       "_id":0,name:1,salary:1}).pretty()
    { "name" : "robinson.cheng", "salary" : 3000 }
    
    //基于$inc的负值
    > db.persons.update({name:"robinson.cheng"},{$inc:{salary:-1500}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    //负值后的结果
    > db.persons.find({name:"robinson.cheng"},{
       "_id":0,name:1,salary:1}).pretty()
    { "name" : "robinson.cheng", "salary" : 1500 }
    
    //下面使用非数字来实现$inc，报错如下
    > db.persons.update({name:"robinson.cheng"},{$inc:{salary:"1.5k"}})
    WriteResult({
            "nMatched" : 0,
            "nUpserted" : 0,
            "nModified" : 0,
            "writeError" : {
                    "code" : 14,
                    "errmsg" : "Cannot increment with non-numeric argument: {salary: \"1.5k\"}"
            }
    })

### 6、时间戳字段的增加及自动更新($currentDate) ###

//有时候需要为文档增加最后的更新时间自动，可以使用$currentDate方式来实现
    //下面为文档增加lastModified时间戳字段
    > db.persons.update({name:"robinson.cheng"},{
       $inc:{salary:1000},$currentDate: {lastModified:true}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    //查看结果
    > db.persons.find({name:"robinson.cheng"},{
       "_id":0,name:1,salary:1,lastModified:1})
    { "name" : "robinson.cheng", "salary" : 2500, "lastModified" : ISODate("2017-02-08T08:23:38.361Z") }
    
    //再次更新
    > db.persons.update({name:"robinson.cheng"},{
       $inc:{salary:500},$currentDate: {lastModified:true}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    //再次查看结果，时间戳自动被自动更新为最新的时间
    > db.persons.find({name:"robinson.cheng"},{
       "_id":0,name:1,salary:1,lastModified:1})
    { "name" : "robinson.cheng", "salary" : 3000, "lastModified" : ISODate("2017-02-08T08:25:26.865Z") }

### 7、文档字段重命名($rename) ###

//下面使用$rename对文档字段重命名
    > db.persons.update({name:"robinson.cheng"},{$rename:{
       "name":"ename"}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    > db.persons.find({ename:"robinson.cheng"},{
       "_id":0,ename:1})
    { "ename" : "robinson.cheng" }
    
    //对子文档字段进行重命名
    > db.persons.update({ename:"robinson.cheng"},{$rename:{
       "score.c":"score.chinese"}})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 })
    
    > db.persons.find({ename:"robinson.cheng"},{
       "_id":0,ename:1,score:1})
    { "score" : { "m" : 96, "e" : 87, "chinese" : 92 }, "ename" : "robinson.cheng" }
    
    //对整个集合上所有文档字段进行重命名
    > db.persons.count()
    12
    
    > db.persons.update({},{$rename:{
       "name":"ename"}},{multi:true})
    WriteResult({ "nMatched" : 12, "nUpserted" : 0, "nModified" : 11 }) //此次修改为11条，因为前面以及修改过1条

## 三、upsert选项用法 ##

// upsert相当于oracle的merge into或者mysql中的replace into // upsert即是当集合中匹配到满足条件的文档时，则更新文档，否则则是新增文档。前提是该选项的值为true，缺省为flase。
    
    > //下面的演示的是匹配到文档时的例子
    > db.persons.update({name:"robinson.cheng"},{$set:{salary:4000}},{upsert:true})
    WriteResult({ "nMatched" : 1, "nUpserted" : 0, "nModified" : 1 }) //此时提示有一个匹配，有一个被更新
    > db.persons.find({name:"robinson.cheng"},{
       "_id":0,name:1,salary:1})
    { "name" : "robinson.cheng", "salary" : 4000 }
    
    > //下面通过upsert方式来新增文档
    > db.persons.find({name:"thomas"}) //查找thomas
    > db.persons.update({name:"thomas"},{$set:{salary:4000,country:"USA",age:25}},{upsert:true})
    WriteResult({
            "nMatched" : 0,
            "nUpserted" : 1, //此处结果表面有一个upserted，即没有对应得文档，更新的内容作为一个新文档插入到集合
            "nModified" : 0,
            "_id" : ObjectId("589ae6f4e3a46ff8c567f1bf")
    })
    > db.persons.find({name:"thomas"})
    { "_id" : ObjectId("589ae6f4e3a46ff8c567f1bf"), "name" : "thomas", "salary" : 4000, "country" : "USA", "age" : 25 }

### 四、小结 ###

a、对于文档上数据的修改有多种方式(修改器)，常用的为$set修改器以及$inc  
b、$inc是一种高效的数据修改器，通常用于实现数值的增加或减少，仅支持数据类型。  
c、对于文档字段的增加，可以使用$set，$unset，$inc，$currentDate等方式  
d、对于文档字段的删除，使用$unset方式来实现  
e、upsert选项可以实现匹配的文档则更新，不匹配时则插入

[![DBA牛鹏社(SQL/NOSQL/LINUX)][DBA_SQL_NOSQL_LINUX]][DBA_SQL_NOSQL_LINUX_DBA_SQL_NOSQL_LINUX]

[MongoDB]: http://blog.csdn.net/leshami/article/details/52903995
[mongoDB]: http://blog.csdn.net/leshami/article/details/52672310
[DBA_SQL_NOSQL_LINUX]: http://pub.idqqimg.com/wpa/images/group.png
[DBA_SQL_NOSQL_LINUX_DBA_SQL_NOSQL_LINUX]: /images/20220711/a09a3c6ddcc0483297867f4ab3fd71c5.png