MongoDB如何批量迁移修改集合的对象数组字段结构

原更新语句失效原因 #

你之前写的updateMany语句存在三个核心问题，无法得到预期结果：

• 使用了数组过滤标识符$[elem]但没有配置对应的arrayFilters匹配规则，数据库无法识别要定位的数组元素
• 将原字段值引用写成了固定字符串"listaItemsIds.$[elem]"，更新时会直接把这段字符串写入item字段，无法读取原数组存储的ObjectId值
• 单个数组元素修改的写法不适合全量数组结构转换场景，容易出现更新遗漏、嵌套结构错误的问题

正确批量更新实现 #

使用MongoDB聚合管道更新的$map操作直接遍历原数组做结构转换即可，不需要逐元素匹配，执行效率更高，适合全量存量数据迁移。

按Schema默认值迁移（property1=0、property2=0） #

执行以下语句，会自动过滤出所有还是旧结构的文档完成转换，不会重复更新已经是新结构的文档：

db.ListSchemas.updateMany(
  // 匹配条件：只更新listaItemsIds数组元素是原始ObjectId类型的旧结构文档
  { "listaItemsIds.0": { $type: "objectId" } },
  [
    {
      $set: {
        listaItemsIds: {
          $map: {
            input: "$listaItemsIds",
            as: "oldItemId",
            in: {
              item: "$$oldItemId",
              property1: 0,
              property2: 0
            }
          }
        }
      }
    }
  ]
)

如果你需要统一设置属性值为示例里的property1:55、property2:75，只需要把上述代码in块里的两个属性值改成对应数字即可。

生产环境操作注意事项 #

• 执行更新前必须先完成集合备份，可通过mongodump单独导出目标集合，避免更新异常导致数据丢失
• 务必先在测试环境验证语句执行结果，确认转换后的数据结构、字段值完全符合预期再操作生产环境
• 数据量较大时建议按_id范围分批次更新，避免一次性操作长时间锁集合影响线上业务
• 迁移完成后执行以下校验语句，返回结果为0即代表所有旧结构文档都已完成迁移：

db.ListSchemas.countDocuments({ "listaItemsIds.0": { $type: "objectId" } })

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