要使用以下过程创建唯一索引，您必须在索引构建期间停止对集合的所有写入。否则，可能在副本集节点之间具有不一致的数据。如果您无法停止对集合的所有写入，请不要使用以下过程创建唯一索引。

警告
如果无法停止对集合的所有写入，请勿使用以下步骤创建唯一索引。
在创建索引之前，请验证集合中是否有任何文档违反索引约束。如果集合分布在分片上，并且分片包含具有重复文档的数据段，则创建索引操作可能会在没有重复项的分片上成功，但不会在有重复项的分片上成功。为避免分片之间留下不一致的索引，您可以发出db.collection.dropIndex() 中的mongos 将索引从集合中删除。

步骤

重要

以滚动方式构建索引的以下过程适用于分片的集群部署，而不是副本集部署。有关副本集的过程，请参阅在副本集上创建滚动索引构建。

A. 停止负载均衡器

Connect mongosh to a mongos instance in the sharded cluster, and run sh.stopBalancer() to disable the balancer: [1]

sh.stopBalancer()

注意

如果迁移正在进行，系统将在停止负载均衡器之前完成进行中的迁移。

要验证是否禁用了负载均衡器，请运行 sh.getBalancerState()；如果已禁用负载均衡器，则会返回 false：

sh.getBalancerState()

[1]	从 MongoDB 6.0.3 开始，不再执行自动数据块分割。这是因为均衡策略的改进。自动分割命令仍然存在，但不执行操作。在 6.0.3 之前的 MongoDB 版本中，`sh.stopBalancer()` 还会禁用分片集群的自动拆分。

B. 确定集合的分配情况

From mongosh connected to the mongos, refresh the cached routing table for that mongos to avoid returning stale distribution information for the collection. Once refreshed, run db.collection.getShardDistribution() for the collection you wish to build the index.

例如，如果您要在 test 数据库中的 records 集合上创建升序索引：

db.adminCommand( { flushRouterConfig: "test.records" } );
db.records.getShardDistribution();

该方法输出分片分配。例如，考虑一个具有 3 个分片（shardA、shardB 和 shardC）的分片集群，db.collection.getShardDistribution() 返回以下内容：

Shard shardA at shardA/s1-mongo1.example.net:27018,s1-mongo2.example.net:27018,s1-mongo3.example.net:27018
 data : 1KiB docs : 50 chunks : 1
 estimated data per chunk : 1KiB
 estimated docs per chunk : 50
Shard shardC at shardC/s3-mongo1.example.net:27018,s3-mongo2.example.net:27018,s3-mongo3.example.net:27018
 data : 1KiB docs : 50 chunks : 1
 estimated data per chunk : 1KiB
 estimated docs per chunk : 50
Totals
 data : 3KiB docs : 100 chunks : 2
 Shard shardA contains 50% data, 50% docs in cluster, avg obj size on shard : 40B
 Shard shardC contains 50% data, 50% docs in cluster, avg obj size on shard : 40B

根据输出，您只能在 shardA 和 shardC 上构建 test.records 的索引。

C. 在包含集合数据块的分片上构建索引

对于包含集合数据段的每个分片，请按照在分片上构建索引的过程进行操作。

C1. 停止一个从节点并重启为独立实例

对于受影响的分片，停止与其从节点之一关联的 mongod 进程。在进行以下配置更新后，重新启动：

如果使用配置文件，请进行以下配置更新：

Change the net.port to a different port. [2] Make a note of the original port setting as a comment.
注释掉 replication.replSetName 选项。
注释掉 sharding.clusterRole 选项。
在 setParameter 部分中将参数 skipShardingConfigurationChecks 设置为 true。
在 setParameter 部分中将参数 disableLogicalSessionCacheRefresh 设置为 true。

例如，对于分片副本集节点，更新后的配置文件将包含类似如下示例的内容：

net:
   bindIp: localhost,<hostname(s)|ip address(es)>
   port: 27218
#   port: 27018
#replication:
#   replSetName: shardA
#sharding:
#   clusterRole: shardsvr
setParameter:
   skipShardingConfigurationChecks: true
   disableLogicalSessionCacheRefresh: true

并重新启动：

mongod --config <path/To/ConfigFile>

其他设置（例如storage.dbPath 等等）保持不变。

如果使用命令行选项，请进行以下配置更新：

Modify --port to a different port. [2]
删除--replSet 。
如果是分片成员，则删除--shardsvr ；如果是配置服务器分片，则删除 { --configsvr 。
在 --setParameter选项中将参数设置为skipShardingConfigurationChecks 。true
在 --setParameter 选项中将参数 disableLogicalSessionCacheRefresh 设置为 true。

例如，在不使用 --replSet 和 --shardsvr 选项的情况下重启分片副本集节点。指定新的端口号并将 skipShardingConfigurationChecks 和 disableLogicalSessionCacheRefresh 参数均设置为 true：

mongod --port 27218 --setParameter skipShardingConfigurationChecks=true --setParameter disableLogicalSessionCacheRefresh=true

其他设置（例如--dbpath 等等）保持不变。

[2]	(1, 2) By running the `mongod` on a different port, you ensure that the other members of the replica set and all clients will not contact the member while you are building the index.

C2. 构建索引

直接连接到在新端口上独立运行的 mongod 实例，并为该实例创建新索引。

For example, connect mongosh to the instance, and use the db.collection.createIndex() method to create an ascending index on the username field of the records collection:

db.records.createIndex( { username: 1 } )

C3。以副本集节点身份重新启动程序 `mongod`

索引构建完成后，关闭 mongod 实例。撤消以独立节点身份启动时所做的配置更改，以恢复其原始配置，并重新启动。

重要

请务必删除 skipShardingConfigurationChecks 和 disableLogicalSessionCacheRefresh 参数。

例如，要重新启动副本集分片成员：

如果您在使用配置文件：

恢复到原始端口号。
取消对 replication.replSetName 的注释。
取消对 sharding.clusterRole 的注释。
移除 setParameter 部分中的参数 skipShardingConfigurationChecks。
删除 setParameter 部分的参数 disableLogicalSessionCacheRefresh。

net:
   bindIp: localhost,<hostname(s)|ip address(es)>
   port: 27018
replication:
   replSetName: shardA
sharding:
   clusterRole: shardsvr

其他设置（例如storage.dbPath 等等）保持不变。

并重新启动：

mongod --config <path/To/ConfigFile>

如果您使用的是命令行选项：

恢复到原始端口号。
包括 --replSet。
如果是分块节点，请包含 --shardsvr；如果是配置服务器节点，请包含 --configsvr。
Remove parameter skipShardingConfigurationChecks.
Remove parameter disableLogicalSessionCacheRefresh.

例如：

mongod --port 27018 --replSet shardA --shardsvr

其他设置（例如--dbpath 等等）保持不变。

允许复制赶上此节点。

C4. 对分片的剩余从节点重复该过程

一旦该节点赶上副本集中的其他节点，逐次逐个对剩余从节点重复该过程：

C1. 停止一个从节点并重启为独立实例
C2. 构建索引
C. 以副本集节点身份重新启动 mongod 程序

E. 在主节点上构建索引

当分片的所有从节点均有新索引时，分片的主节点降级，通过上述过程将其重启为独立运行的节点，然后在前一个主节点上构建索引：

Use the rs.stepDown() method in mongosh to step down the primary. Upon successful stepdown, the current primary becomes a secondary and the replica set members elect a new primary.
C1. 停止一个从节点并重启为独立实例
C2. 构建索引
C. 以副本集节点身份重新启动 mongod 程序

D. 对其他受影响的分片重复上述步骤

在完成构建分片的索引后，为其他受影响的分片重复执行 C. 在包含集合数据块的分片上构建索引。

E. 重新启动负载均衡器

在完成受影响的分片的滚动索引构建后，重新启动负载均衡器。

Connect mongosh to a mongos instance in the sharded cluster, and run sh.startBalancer(): [3]

sh.startBalancer()

[3]	从 MongoDB 6.0.3 开始，不再执行自动数据块分割。这是因为均衡策略的改进。自动分割命令仍然存在，但不执行操作。在 6.0.3 之前的 MongoDB 版本中，`sh.startBalancer()` 还支持分片集群的自动拆分。

在分片集群上创建滚动索引构建

关于此任务

Considerations

Unique Indexes

Oplog 大小

先决条件

步骤