唯一索引

在本页面

• 创建唯一索引

• 行为

唯一索引确保索引字段不会存储重复值;例如，强制索引字段的唯一性。默认情况下，MongoDB在创建集合期间在_id字段上创建一个唯一的索引。

新的内部格式

从MongoDB 4.2开始，对于4.2（或更高版本）的featureCompatibilityVersion（fCV），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集合的groupNumber， lastname和firstname字段上创建一个唯一的索引，在mongo shell中使用以下操作:

db.members.createIndex( { groupNumber: 1, lastname: 1, firstname: 1 }, { unique: true } )

创建的索引强制groupNumber、lastname和firstname值的_组合_的唯一性。

再举一个例子，考虑一个包含以下文档的集合:

{ _id: 1, a: [ { loc: "A", qty: 5 }, { qty: 10 } ] }

创建一个独特的复合multikey索引在a.loc和a.qty:

db.collection.createIndex( { "a.loc": 1, "a.qty": 1 }, { unique: true } )

唯一索引允许将以下文档插入到集合中，因为索引强制a.loc和a.qty值组合的唯一性：

db.collection.insert( { _id: 2, a: [ { loc: "A" }, { qty: 5 } ] } )
db.collection.insert( { _id: 3, a: [ { loc: "A", qty: 10 } ] } )

也可以看看：

跨不同文档的唯一约束和唯一索引和丢失字段

行为

限制

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

不能在hashed索引上指定唯一的约束。

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

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

• db.collection.createIndex()在主数据库上发布副本集，

• db.collection.createIndex()在分片mongos群集上发出。

跨不同文档的唯一约束

唯一约束适用于集合中的不同文档。也就是说，唯一索引防止_单独的_文档对索引键具有相同的值。

因为约束适用于单独的文档,一个独特的多键索引,一个文档可能数组元素,导致重复索引键值,只要文档不重复的索引键值的另一个文档。在本例中，重复索引条目只插入索引一次。

例如，考虑一个包含以下文档的集合:

{ _id: 1, a: [ { loc: "A", qty: 5 }, { qty: 10 } ] }
{ _id: 2, a: [ { loc: "A" }, { qty: 5 } ] }
{ _id: 3, a: [ { loc: "A", qty: 10 } ] }

在a.loc和a.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 }"
   }
})

也可以看看：

Unique Partial Indexes

独特的部分索引

3.2版本新增.

部分索引只索引集合中满足指定筛选器表达式的文档。如果您同时指定了partialFilterExpression和一个unique约束，唯一约束只适用于满足筛选器表达式的文档。

如果文档不满足筛选条件，则具有唯一约束的部分索引不会阻止插入不满足唯一约束的文档。例如，请参阅带有唯一约束的部分索引。

分片集群和唯一索引

您不能在hashed索引上指定唯一的约束。

对于一个范围分片集合，只有以下索引可以是唯一的:

• 分片键上的索引

• 一个复合索引，其中片键是一个前缀

• 默认_id索引；不过，该_id指数仅实施每碎片的唯一性约束**，如果该_id字段是不是**分片键或片键的前缀。

  唯一性和_ID索引

  如果_id字段不是分片键或分片键的前缀，_id索引只对每个分片强制唯一性约束，而对各个分片强制而不是。

唯一的索引约束意味着:

• 对于要分片的集合，如果该集合有其他唯一索引，则不能对该集合进行分片。

• 对于已经分片的集合，不能在其他字段上创建唯一索引。