addShard
定义
addShard将分分片副本集添加到分片集群。
提示
在
mongosh中，还可以通过sh.addShard()辅助方法运行此命令。辅助方法对
mongosh用户来说很方便，但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段，请使用数据库命令。
兼容性
此命令可用于以下环境中托管的部署：
MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务
重要
无服务器实例不支持此命令。 有关更多信息，请参阅不支持的命令。
MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本
语法
该命令具有以下语法：
{ addShard: "<replica_set>/<hostname><:port>", maxSize: <size>, name: "<shard_name>" }
命令字段
该命令包含以下字段：
字段 | 类型 | 说明 | |
|---|---|---|---|
addShard | 字符串 | 分片副本集至少一个成员的副本集名称、主机名和端口。任何其他副本集节点主机名都必须以逗号分隔。 例如： | |
maxSize | 整型 | 可选。 分片的最大大小（以 MB 为单位）。 如果将 maxSize设置为0 ，则 MongoDB 不限制分片的大小。 | |
name | 字符串 | 可选。 分片的名称。 如果未指定，MongoDB 会自动提供一个唯一名称。 |
addShard命令将分分片配置信息存储在配置数据库中。 使用admin数据库时，始终运行addShard 。
如果您的计算机具有不同的磁盘容量，或者您想限制某些分片的数据量，请指定maxSize 。 maxSize当在分片上运行 totalSizelistDatabasesmaxSize返回的 超过 的值时， 约束会阻止 负载均衡器 将数据块迁移到分片。
Considerations
均衡
将分片添加到分片集群时，会影响所有现有分片collection的集群分数据块之间的数据段平衡。负载均衡器将开始迁移数据块，以便集群实现平衡。有关更多信息，请参阅集群负载均衡器。
数据块迁移可能会对磁盘空间产生影响，因为源分片默认会自动存档迁移的文档。有关详细信息，请参阅moveChunk目录。
隐藏成员
示例
以下命令将副本集添加为分片：
use admin db.runCommand( { addShard: "repl0/mongodb3.example.net:27327"} )
警告
请勿使用localhost作为主机名，除非您的配置服务器也在localhost上运行。