MongoDB 3.6版本如何批量重命名嵌套字段中的键名

问题根因分析 #

• 现有代码错误使用$set操作符，仅会把classes.History的字段值修改为字符串HISTORY_NEW，并非重命名键名，完全达不到预期效果
• 逐条遍历发送updateOne请求会产生大量不必要的网络IO和数据库请求开销，性能极低

原生高效实现方案 #

完全可以通过MongoDB原生操作实现需求，不需要额外业务代码处理，使用$rename操作符配合updateMany批量更新即可，代码如下：

// 建议执行更新前先运行，校验匹配的记录数是否符合预期
db.studentSubject.find({"classes.History": {$exists: true}}).countDocuments()

// 执行批量更新
db.studentSubject.updateMany(
  // 匹配条件：仅更新存在classes.History字段的记录
  { "classes.History": { $exists: true } },
  // 重命名字段，自动保留原有所有嵌套属性值
  { $rename: { "classes.History": "classes.HISTORY_NEW" } }
)

方案优势 #

• 仅需1次数据库交互，无额外数据拉取、循环请求开销，3万条记录可在毫秒到秒级完成更新，性能远高于逐条操作
• $rename操作符原生支持保留字段下所有嵌套属性，TeacherName、Marks等原有值不会丢失
• 完全兼容MongoDB 3.6版本，无需额外版本适配

注意事项 #

• 执行更新前建议先备份集合数据，避免误操作导致数据损坏
• 如果业务场景中可能存在已有的classes.HISTORY_NEW字段，可在匹配条件中增加"classes.HISTORY_NEW": {$exists: false}避免原有数据被覆盖
• 更新完成后可执行以下命令验证结果：

  // 校验更新成功的记录数
  db.studentSubject.find({"classes.HISTORY_NEW": {$exists: true}}).countDocuments()
  // 校验是否还有残留的History字段
  db.studentSubject.find({"classes.History": {$exists: true}}).countDocuments()
  

内容的提问来源于stack exchange，提问作者S_Nambiar