MongoDB $rename 给字段一次重新命名的机会

学习mongodb,体会mongodb的每一个使用细节,欢迎阅读威赞的文章。这是威赞发布的第58篇mongodb技术文章,欢迎浏览本专栏威赞发布的其他文章。

在日常编写程序过程中,命名错误是经常出现的错误。拼写错误的单词,大小写字母的错误等。还有另外一种场景,一些字段定义在文档的顶层,而随着项目的进展,开发人员期望将字段移动到文档的嵌套文档当中。

Mongodb的$rename方法,为开发人员提供了字段名称修改的便利。同时该方法也支持嵌套文档字段的移动。

定义

操作符$rename修改字段的名称

语法

复制代码
{ $rename: {<field1>: <newName1>, <field2>: <newName2>, ...}}

其中,新的字段名称必须与已有字段不同。

在下面的更新语句中,将字段名称nickname更新为字段 alias, 同时将字段cell更新为mobile

复制代码
db.students.updateOne(
    {_id: 1}, {$rename: {'nickname': 'alias', 'cell': 'mobile'}}
)

行为

当在UPDATE中使用$rename操作时,Mongodb完成了下面的行为

  • 使用$unset删除带有原来字段名称的字段和新字段名称的字段。
  • 执行$set操作,将字段值和新字段名称添加到文档中。

使用rename时,对每个文档的操作是原子操作。rename操作可能不会保留文档中字段排序。支持将字段从嵌套文档中搬入搬出。但不支持文档数组中字段的搬入和搬出。

当文档中存在与新字段名称相同的字段时,文档中已有同名字段会被删除。

重命名文档中不存在的字段时,使用$rename操作不会对文档进行更新。

mongodb 5.0版本以后,向$rename传入空表达式({ })时,mongodb不再抛出错误。空表达式不会修改字段值 ,也不会在oplog中,添加新的操作记录。

应用

构建测试集合students并插入数据。能够看到,插入集合中字段名称"nmae"输入错误。

复制代码
db.students.insertMany([
    {
        "_id": 1, 
        "alias": ["The American Cincinnatus", "The American Fabius"],
        "mobile": "555-555-5555",
        "nmae": { "first": "george","last": "washington"}
    }, {
        "_id": 2, 
        "alias": ["My dearest friend"],
        "mobile": "222-222-2222",
        "nmae": { "first": "abigail","last": "adams"}
    }, {
        "_id": 3, 
        "alias": ["Amazing grace"],
        "mobile": "111-111-1111",
        "nmae": { "first": "grace","last": "hopper"}
    }
    ])

构建数据更新语句,修改字段名称。

复制代码
db.students.updateMany(
    {"nmae": {$ne: null}},
    {$rename: {"nmae": "name"}}
    )  

构建另外一个UPDATE语句,修改嵌套文档中的名称。

复制代码
db.students.updateOne(
    {_id: 1},
    { $rename: {"name.first": "name.fname"}}
    )   

修改一个不存在的字段名称。返回结果中修改文档数量为0

复制代码
db.students.updateOne({_id: 1}, {$rename: {'wife': 'spouse'}})    
{
	"acknowledged" : true,
	"matchedCount" : 1,
	"modifiedCount" : 0
}
相关推荐
你想考研啊9 分钟前
二、redis集群部署(3主3从)
数据库·redis·缓存
冉冰学姐28 分钟前
SSM考试管理z2zvx(程序+源码+数据库+调试部署+开发环境)带论文文档1万字以上,文末可获取,系统界面在最后面。
数据库·ssm 框架·学生信息管理
友友马32 分钟前
『 QT 』信号-槽 补充: Qt信号槽断开连接与Lambda槽技巧
开发语言·数据库·qt
凡间客1 小时前
5、Python3编程之面向对象
java·服务器·数据库
涛思数据(TDengine)1 小时前
TDengine TSDB 3.3.8.0 上线:SMA、TLS、TDgpt、taosX、taosgen 一次全进化
大数据·数据库·时序数据库·tdengine
滴_咕噜咕噜1 小时前
【MFC】数据库操作:数据库动态生成
数据库·c++·mfc
YaoYuan93232 小时前
Ubuntu22.04 中搭建基于 Qemu 的内核(驱动)开发环境
数据库
hans汉斯2 小时前
【计算机科学与应用】基于多光谱成像与边缘计算的物流安全风险预警模式及系统实现
大数据·数据库·人工智能·设计模式·机器人·边缘计算·论文笔记
叫我龙翔2 小时前
【MySQL】从零开始了解数据库开发 --- 如何理解事务隔离性
数据库·mysql·数据库开发
你想考研啊3 小时前
一、redis安装(单机)和使用
前端·数据库·redis