MongoDB-CN-Manual
搜索文档…
唯一索引
在本页面
唯一索引确保索引字段不会存储重复值;例如,强制索引字段的唯一性。默认情况下,MongoDB在创建集合期间在_id字段上创建一个唯一的索引。
新的内部格式
从MongoDB 4.2开始,对于4.2(或更高版本)的featureCompatibilityVersionfCV),MongoDB使用一种新的内部格式来存储与早期MongoDB版本不兼容的唯一索引。新格式适用于现有的唯一索引以及新创建/重建的唯一索引。

创建唯一索引

要创建一个唯一的索引,使用db.collection.createIndex()方法,并将unique选项设置为true
db.collection.createIndex( <key and index type specification>, { unique: true } )

单个字段上的唯一索引

例如,要在members集合的user_id字段上创建一个唯一的索引,在mongo shell中使用以下操作:
db.members.createIndex( { "user_id": 1 }, { unique: true } )

独特的复合索引

您还可以在复合索引上强制执行唯一约束。如果您在复合索引上使用唯一约束,那么MongoDB将对索引键值的_组合_执行惟一性。
例如,要在members集合的groupNumberlastnamefirstname字段上创建一个唯一的索引,在mongo shell中使用以下操作:
db.members.createIndex( { groupNumber: 1, lastname: 1, firstname: 1 }, { unique: true } )
创建的索引强制groupNumberlastnamefirstname值的_组合_的唯一性。
再举一个例子,考虑一个包含以下文档的集合:
{ _id: 1, a: [ { loc: "A", qty: 5 }, { qty: 10 } ] }
创建一个独特的复合multikey索引在a.loca.qty:
db.collection.createIndex( { "a.loc": 1, "a.qty": 1 }, { unique: true } )
唯一索引允许将以下文档插入到集合中,因为索引强制a.loca.qty值组合的唯一性:
db.collection.insert( { _id: 2, a: [ { loc: "A" }, { qty: 5 } ] } )
db.collection.insert( { _id: 3, a: [ { loc: "A", qty: 10 } ] } )
也可以看看:

行为

限制

如果集合已经包含了违反索引的唯一约束的数据,MongoDB不能在指定的索引字段上创建一个唯一索引
不能在hashed索引上指定唯一的约束。

在复制集和分片集群上建立唯一索引

对于复制集和分片集群,使用滚动过程创建唯一索引需要在过程中停止对集合的所有写操作。如果不能在过程中停止对集合的所有写操作,则不要使用滚动过程。相反,在集合上建立你的唯一索引:

跨不同文档的唯一约束

唯一约束适用于集合中的不同文档。也就是说,唯一索引防止_单独的_文档对索引键具有相同的值。
因为约束适用于单独的文档,一个独特的多键索引,一个文档可能数组元素,导致重复索引键值,只要文档不重复的索引键值的另一个文档。在本例中,重复索引条目只插入索引一次。
例如,考虑一个包含以下文档的集合:
{ _id: 1, a: [ { loc: "A", qty: 5 }, { qty: 10 } ] }
{ _id: 2, a: [ { loc: "A" }, { qty: 5 } ] }
{ _id: 3, a: [ { loc: "A", qty: 10 } ] }
a.loca.qty上创建唯一的复合多键索引:
db.collection.createIndex( { "a.loc": 1, "a.qty": 1 }, { unique: true } )
如果集合中的其他文档的索引 key value 为{ "a.loc": "B", "a.qty": null },则唯一索引允许将以下文档插入到集合中。
db.collection.insert( { _id: 4, a: [ { loc: "B" }, { loc: "B" } ] } )

唯一索引和丢失字段

如果文档在唯一索引中没有索引字段的值,索引将为该文档存储空值。由于唯一的约束,MongoDB将只允许一个没有索引字段的文档。如果有多个文档没有索引字段的值或缺少索引字段,索引构建将失败,并出现重复键错误。
例如,一个集合在x上有一个唯一的索引:
db.collection.createIndex( { "x": 1 }, { unique: true } )
如果集合中没有包含缺少x字段的文档,唯一索引允许插入没有x字段的文档:
db.collection.insert( { y: 1 } )
但是,如果集合中已经包含了一个没有字段x的文档,则在插入一个没有字段x的文档时出现唯一的索引错误:
db.collection.insert( { z: 1 } )
由于违反了字段x值的唯一约束,操作无法插入文档:
WriteResult({
"nInserted" : 0,
"writeError" : {
"code" : 11000,
"errmsg" : "E11000 duplicate key error index: test.collection.$a.b_1 dup key: { : null }"
}
})
也可以看看:

独特的部分索引

3.2版本新增.
部分索引只索引集合中满足指定筛选器表达式的文档。如果您同时指定了partialFilterExpression和一个unique约束,唯一约束只适用于满足筛选器表达式的文档。
如果文档不满足筛选条件,则具有唯一约束的部分索引不会阻止插入不满足唯一约束的文档。例如,请参阅带有唯一约束的部分索引

分片集群和唯一索引

您不能在hashed索引上指定唯一的约束。
对于一个范围分片集合,只有以下索引可以是唯一的:
  • 分片键上的索引
  • 一个复合索引,其中片键是一个前缀
  • 默认_id索引;不过,该_id指数仅实施每碎片的唯一性约束**,如果_id字段是不是**分片键或片键的前缀。
    唯一性和_ID索引
    如果_id字段不是分片键或分片键的前缀,_id索引只对每个分片强制唯一性约束,而对各个分片强制而不是
唯一的索引约束意味着:
  • 对于要分片的集合,如果该集合有其他唯一索引,则不能对该集合进行分片。
  • 对于已经分片的集合,不能在其他字段上创建唯一索引。
复制链接
大纲
创建唯一索引
单个字段上的唯一索引
独特的复合索引
行为
限制
在复制集和分片集群上建立唯一索引
跨不同文档的唯一约束
唯一索引和丢失字段
独特的部分索引
分片集群和唯一索引