本文將會介紹 MongoDB $rename 操作符，它可以用于重命名文檔中的字段。

$rename 操作符

$rename 是一個字段更新操作符，可以用于修改文檔的字段名。

$rename 操作符的語法如下：

{ $rename: { <field_name>: <new_field_name>, ...}}

其中，新的字段名 <new_field_name> 必須和原字段名 <field_name> 不同。

如果文檔中已經存在一個名為 <new_field_name> 的字段，$rename 操作符將會刪除該字段，然后將字段 <field_name> 改名為 <new_field_name>。

如果文檔中不存在名為 <field_name> 的字段，$rename 操作符不會執行任何操作，也不會返回任何警告或者錯誤。

$rename 操作符可以修改嵌入式文檔中的字段名，也可以將字段移入或者移出嵌入式文檔。

$rename 示例

首先創建以下集合：

db.products.insertMany([{ "_id" : 1, "nmea" : "xPhone", "price" : 799, "releaseDate": ISODate("2011-05-14"), "spec" : { "ram" : 4, "screen" : 6.5, "cpu" : 2.66 },"color":["white","black"],"storage":[64,128,256]},{ "_id" : 2, "nmea" : "xTablet", "price" : 899, "releaseDate": ISODate("2011-09-01") , "spec" : { "ram" : 16, "screen" : 9.5, "cpu" : 3.66 },"color":["white","black","purple"],"storage":[128,256,512]},{ "_id" : 3, "nmea" : "SmartTablet", "price" : 899, "releaseDate": ISODate("2015-01-14"), "spec" : { "ram" : 12, "screen" : 9.7, "cpu" : 3.66 },"color":["blue"],"storage":[16,64,128]},{ "_id" : 4, "nmea" : "SmartPad", "price" : 699, "releaseDate": ISODate("2020-05-14"),"spec" : { "ram" : 8, "screen" : 9.7, "cpu" : 1.66 },"color":["white","orange","gold","gray"],"storage":[128,256,1024]},{ "_id" : 5, "nmea" : "SmartPhone", "price" : 599,"releaseDate": ISODate("2022-09-14"), "spec" : { "ram" : 4, "screen" : 5.7, "cpu" : 1.66 },"color":["white","orange","gold","gray"],"storage":[128,256]}])

示例一：修改字段的名稱

以下示例使用 $rename 操作符將拼寫錯誤的字段名“nmea”修改為“name”：

db.products.updateMany({}, {$rename: {nmea: "name"} })

返回的結果如下：

{acknowledged: true,insertedId: null,matchedCount: 5,modifiedCount: 5,upsertedCount: 0 }

查詢 products 集合中的文檔，驗證修改后的字段名：

db.products.find({}, { name: 1 })[{ _id: 1, name: 'xPhone' },{ _id: 2, name: 'xTablet' },{ _id: 3, name: 'SmartTablet' },{ _id: 4, name: 'SmartPad' },{ _id: 5, name: 'SmartPhone' } ]

示例二：修改嵌入式文檔中的字段名稱

以下示例使用 $rename 操作符將嵌入式文檔 spec 中的字段 size 重命名為 screenSize：

db.products.updateMany({}, {$rename: {"spec.screen": "spec.screenSize"} })

返回結果如下：

{acknowledged: true,insertedId: null,matchedCount: 5,modifiedCount: 0,upsertedCount: 0 }

再次查詢 products 集合中的文檔：

db.products.find({}, {spec: 1 })[{ _id: 1, spec: { ram: 4, cpu: 2.66, screenSize: 6.5 } },{ _id: 2, spec: { ram: 16, cpu: 3.66, screenSize: 9.5 } },{ _id: 3, spec: { ram: 12, cpu: 3.66, screenSize: 9.7 } },{ _id: 4, spec: { ram: 8, cpu: 1.66, screenSize: 9.7 } },{ _id: 5, spec: { ram: 4, cpu: 1.66, screenSize: 5.7 } } ]

示例三：移出嵌入式文檔中的字段

以下示例使用 $rename 操作符將文檔（_id: 1）中的嵌入式文檔 spec 的字段 cpu 修改為頂層字段：

db.products.updateOne({_id: 1 }, {$rename: {"spec.cpu": "cpu"} })

返回結果如下：

{acknowledged: true,insertedId: null,matchedCount: 1,modifiedCount: 1,upsertedCount: 0 }

再次查詢該文檔：

db.products.find({ _id: 1})[{_id: 1,price: 799,releaseDate: ISODate("2011-05-14T00:00:00.000Z"),spec: { ram: 4, screenSize: 6.5 },color: [ 'white', 'black' ],storage: [ 64, 128, 256 ],name: 'xPhone',cpu: 2.66} ]

示例四：替代已有字段

接下來的示例使用 $rename 操作符將文檔（_id: 2）中的 color 字段重命名為 storage。不過，該文檔中已經存在一個名為 storage 的字段。因此， $rename 操作符會將原有的 storage 字段刪除，并且將原有的 color 字段重命名為 storage：

db.products.updateOne({_id: 2 }, {$rename: {"color": "storage"} })

返回結果如下：

{acknowledged: true,insertedId: null,matchedCount: 1,modifiedCount: 0,upsertedCount: 0 }

查看該文檔中的內容：

db.products.find({ _id: 2 })[{_id: 2,price: 899,releaseDate: ISODate("2011-09-01T00:00:00.000Z"),spec: { ram: 16, cpu: 3.66, screenSize: 9.5 },storage: [ 'white', 'black', 'purple' ],name: 'xTablet'} ]

總結

以上是生活随笔為你收集整理的《MongoDB入门教程》第19篇 文档更新之$rename操作符的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。