/ /

/ /

将现有索引转换为唯一索引

要将非唯一索引转换为唯一索引，请使用collMod命令。 collMod命令提供了一些选项，用于在完成转换之前验证索引字段是否包含唯一值。

开始之前

填充示例数据

创建 apples 集合：

db.apples.insertMany( [
   { type: "Delicious", quantity: 12 },
   { type: "Macintosh", quantity: 13 },
   { type: "Delicious", quantity: 13 },
   { type: "Fuji", quantity: 15 },
   { type: "Washington", quantity: 10 }
] )

创建单个字段索引

在 type 字段上添加单个字段索引：

db.apples.createIndex( { type: 1 } )

步骤

准备要转换为唯一索引的索引

在 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 documents
were detected. Please resolve them and rerun collMod.

在这种情况下，请解决重复条目，直到响应低于 8MB，然后再次运行collMod 以查看剩余的违规情况。

解决重复键冲突

要完成转换，请修改重复条目以消除任何冲突。例如：

db.apples.deleteOne(
   { _id: ObjectId("660489d24cabd75abebadbd2") }
)

确认所有冲突均已解决

要确认可以转换索引，请使用 dryRun: true 重新运行 collMod() 命令：

db.runCommand( {
   collMod: "apples",
   index: {
      keyPattern: { type: 1 },
      unique: true
   },
   dryRun: true
} )

{ ok: 1 }

完成索引转换

如要完成到唯一索引的转换，请运行 unique: true 的 collMod 命令并删除 dryRun 标记：

db.runCommand( {
   collMod: "apples",
   index: {
      keyPattern: { type: 1 },
      unique: true
   }
} )

{ unique_new: true, ok: 1 }

了解详情