文档中心

文档数据库 MongoDB 版

变更分片集群实例配置

变更 Shard 分片配置

您可以根据业务量变动，灵活变更 MongoDB 分片集群实例中单个或多个 Shard 分片的配置，包括升降节点规格、增减分片数量或存储空间等。本文介绍相关操作步骤。

注意事项

针对创建时间早于 2022 年 07 月 04 日的分片集群实例，在首次变更 Shard 分片数量后，需要先重置数据库账号密码，才能直连 Shard 分片，否则会由于密码错误导致连接失败。重置密码的方法，请参见重置密码。

变配预检查

在执行变更实例配置操作前，文档数据库 MongoDB 版会预先对实例健康状态进行检查，确保实例各项健康监控指标符合变配要求，以降低因配置变更导致异常的可能性。若在实例变配的预检查阶段出现了相关报错，请参见在变更实例配置的预检查阶段出现了报错，该如何处理中的建议尝试解决。

费用说明

关于实例的变更实例配置费用结算规则详情，请参见按量计费和包年包月。

变更指定 Shard 分片配置

在顶部菜单栏，选择实例所属的项目和地域。

在左侧导航栏中选择分片集实例列表。

在分片集实例列表页，单击目标实例的名称。

在实例信息页签下的节点信息区域，单击 Shards 页签。

从 Shards 页签的分片列表中找到目标 Shard，在右侧操作栏中单击变更配置。

在变更配置页的变更配置区域，设置如下参数。

参数	说明
实例类型	固定为分片集群，无需设置。
可用区	固定为实例当前已选择的可用区，无需设置。说明变更只读节点数量操作与 Shard 分片的其它配置变更操作互斥，即变更 Shard 节点规格或存储空间时，不支持同时变更只读节点数量。更多关于只读节点的说明，请参见 MongoDB 只读节点。如需修改分片集群实例的只读节点数量，请参见添加或删除只读节点。
分片节点数	每个 Shard 分片默认包含 3 个节点，无需设置。
节点规格	您可以升级或降级 Shard 节点规格，每个分片中的每个节点规格一致。更多详情，请参见计算节点规格。说明若实例中存在只读节点，当变更分片实例中 Shard 节点规格时，当前分片中的只读节点的规格也会同步变更。
存储空间	您可以增加、缩减存储空间或保持不变。单位：GiB，步长：10。说明节点规格不同，支持的存储空间范围也不同，存储空间的具体取值范围请以控制台为准。若您有更大存储需求，请提交工单联系技术提升存储空间上限。如果需要变更存储空间，为保证变更后的实例能正常运行，变更后的存储空间容量需大于或等于已使用空间的 1.2 倍。

确认变更后的规格性能详情（例如分片数、节点数、存储空间等），在页面右下角，单击确认订单。

根据实例的计费类型完成后续步骤。

说明

实例状态变为变更配置中，即表示正在变更。当实例状态显示为运行中，即表示变更成功。

批量变更 Shard 分片配置

说明

仅当实例中不存在只读节点，且所有 Shard 分片的配置（包括节点规格和存储空间）一样时，才支持开启批量修改 Shard 分片配置功能。更多关于只读节点的说明，请参见 MongoDB 只读节点。

在顶部菜单栏，选择实例所属的项目和地域。

在左侧导航栏中选择分片集实例列表。

在分片集实例列表页找到目标实例，单击右侧操作列中的变更配置。

说明

当实例中存在只读节点时，变更配置按钮会置灰（即不支持批量变更 Shard 分片配置）。

在变更配置页的变更配置区域，设置如下参数。

参数	说明
实例类型	固定为分片集群，无需设置。
可用区	固定为实例当前已选择的可用区，无需设置。说明如需修改分片集群实例的只读节点数量，请参见添加或删除只读节点。
批量修改 Shard	打开批量修改Shard 开关。说明若实例中不同 Shard 分片的配置（包括节点规格和存储空间）不一致时，批量修改Shard 开关将无法打开（即不支持批量变更 Shard 分片配置）。您可以在变更配置页同时修改 Mongos 节点的配置，具体操作步骤，请参见变更 Mongos 节点配置。
分片数	您可以增加分片或保持不变，不支持减少分片。
分片节点数	每个 Shard 分片默认包含 3 个节点，无需设置。
节点规格	您可以升级或降级 Shard 节点规格，每个分片中的每个节点规格一致。更多详情，请参见计算节点规格。
存储空间	您可以增加存储空间或保持不变。单位：GiB，步长：10。说明节点规格不同，支持的存储空间范围也不同，存储空间的具体取值范围请以控制台为准。若您有更大存储需求，请提交工单联系技术提升存储空间上限。如果需要变更存储空间，为保证变更后的实例能正常运行，变更后的存储空间容量需大于或等于已使用空间的 1.2 倍。批量变更 Shard 分片配置时不支持缩减存储空间。如需缩减存储空间，请为指定分片单独执行对应操作。具体操作步骤请参见变更指定 Shard 分片配置。

确认变更后的规格性能详情（例如分片数、节点数、存储空间等），在页面右下角，单击确认订单。

根据实例的计费类型完成后续步骤。

说明

实例状态变为变更配置中，即表示正在变更。当实例状态显示为运行中，即表示变更成功。

添加 Shard 分片

说明

当前仅支持添加 Shard 分片，不支持减少 Shard 分片。

新增分片后，系统需要一定时间将数据均衡到新分片上，耗时与数据量成正比。请等待均衡完成，分片的扩展能力才能完全生效。

在顶部菜单栏，选择实例所属的项目和地域。

在实例列表页，单击目标实例的名称。

在实例信息页签下的节点信息区域，单击 Shards 页签。

在 Shards 页签下单击添加 Shard。

在变更配置页的变更配置区域，设置如下参数。

参数	说明
实例类型	固定为分片集群，无需设置。
可用区	固定为实例当前已选择的可用区，无需设置。说明您可以在添加 Shard 分片时，为新增分片设置只读节点数。每个 Shard 分片最多可添加 5 个只读节点。更多关于只读节点的功能介绍和使用限制，请参见 MongoDB 只读节点。
分片数	设置需要添加的 Shard 分片数量。单个实例中最多可增加至 32 个分片。
分片节点数	每个 Shard 分片默认包含 3 个节点，无需设置。
节点规格	设置 Shard 节点规格，每个分片中的每个节点规格一致。更多详情，请参见计算节点规格。说明若新增分片中使用了只读节点，只读节点的规格会与 Shard 分片的主从节点规格保持一致。
存储空间	设置新增分片的存储空间。单位：GiB，步长：10。说明节点规格不同，支持的存储空间范围也不同，存储空间的具体取值范围请以控制台为准。若您有更大存储需求，请提交工单联系技术提升存储空间上限。如果需要变更存储空间，为保证变更后的实例能正常运行，变更后的存储空间容量需大于或等于已使用空间的 1.2 倍。

确认变更后的规格性能详情（例如分片数、节点数、存储空间等），在页面右下角，单击确认订单。

根据实例的计费类型完成后续步骤。

说明

实例状态变为变更配置中，即表示正在变更。当实例状态显示为运行中，即表示变更成功。

API	描述
ModifyDBInstanceSpec	调用 ModifyDBInstanceSpec 接口修改目标 MongoDB 实例的配置（例如节点规格或存储空间）。