本文将会介绍 MongoDB $rename 操作符，它可以用于重命名文档中的字段。

成都创新互联专注于企业成都全网营销推广、网站重做改版、兴和网站定制设计、自适应品牌网站建设、成都h5网站建设、购物商城网站建设、集团公司官网建设、成都外贸网站建设、高端网站制作、响应式网页设计等建站业务，价格优惠性价比高，为兴和等各大城市提供网站开发制作服务。$rename 操作符

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

$rename 操作符的语法如下：

{$rename: {:, ...}}

其中，新的字段名必须和原字段名不同。

如果文档中已经存在一个名为的字段，$rename 操作符将会删除该字段，然后将字段改名为。

如果文档中不存在名为的字段，$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'
  }
]

你是否还在寻找稳定的海外服务器提供商？创新互联www.cdcxhl.cn海外机房具备T级流量清洗系统配攻击溯源，准确流量调度确保服务器高可用性，企业级服务器适合批量采购，新人活动首月15元起，快前往官网查看详情吧

当前标题：《MongoDB入门教程》第19篇文档更新之$rename操作符-创新互联
标题路径：http://lszwz.com/article/doseoj.html