要将非唯一索引转换为唯一索引,请使用collMod命令。 collMod命令提供了一些选项,用于在完成转换之前验证索引字段是否包含唯一值。
关于此任务
collMod 命令转换现有索引。 MongoDB会扫描索引是否存在重复键,然后将该索引标记为唯一。
转换索引时,请记住以下行为:
在转换索引之前,将
prepareUnique设置为true。如果prepareUnique为false,则带有unique: true的collMod会返回错误。在单独的
collMod命令中运行prepareUnique修改。不能将prepareUnique与其他索引修改结合使用。您无法在时间序列集合中的索引上设立
prepareUnique。 MongoDB返回错误。如果在
collMod转换索引时另一个操作修改或删除了该索引,则该命令将失败。其他操作完成后重新运行该命令。
对于分片的集合,以下行为也适用:
如果任何分片包含重复键,则
collMod将返回CannotConvertIndexToUnique。 MongoDB不会转换任何分片上的索引。
开始之前
步骤
准备要转换为唯一索引的索引
在 type 字段索引上运行 collMod 并将 prepareUnique 设置为 true:
db.runCommand( { collMod: "apples", index: { keyPattern: { type: 1 }, prepareUnique: true }} )设置 prepareUnique 后,您将无法插入与索引键条目重复的新文档。例如,以下插入操作会导致错误:
db.apples.insertOne( { type: "Delicious", quantity: 20 } )MongoServerError: E11000 duplicate key error collection:test.apples index: type_1 dup key: { type: "Delicious" }检查唯一键违规
要查看是否有任何文档违反了 type 字段的唯一约束,请使用 unique: true 和 dryRun: true 运行 collMod:
db.runCommand( { collMod: "apples", index: { keyPattern: { type: 1 }, unique: true }, dryRun: true} )MongoServerError: Cannot convert the index to unique. Please resolve conflicting documents before running collMod again.
Violations: [ { ids: [ ObjectId("660489d24cabd75abebadbd0"), ObjectId("660489d24cabd75abebadbd2") ] }]注意
如果包含所有冲突的文档 _id 值的响应超过 8MB,MongoDB 将返回以下错误消息,而不是列出具体的违规:
Cannot convert the index to unique. Too many conflicting documentswere detected. Please resolve them and rerun collMod.在这种情况下,解决重复条目,直到响应小于 8MB,然后再次运行 collMod,以查看剩余的违规条目。