Docs 菜单

Docs 主页开发应用程序MongoDB Manual

addShard

在此页面上

  • 定义
  • 考虑因素
  • 举例
addShard

将分片副本集添加到分片集群。

提示

mongosh中,该命令也可以通过sh.addShard()辅助方法运行。

助手方法对于mongosh用户来说很方便,但它们返回的信息级别可能与数据库命令不同。如果不追求方便或需要额外的返回字段,请使用数据库命令。

addShard连接到 实例时运行mongos 。该命令采用以下形式添加分片副本集:

{ addShard: "<replica_set>/<hostname><:port>", maxSize: <size>, name: "<shard_name>" }

该命令包含以下字段:

字段
类型
说明
addShard
字符串

分片副本集至少一个成员的副本集名称、主机名和端口。任何其他副本集节点主机名都必须以逗号分隔。 例如:

<replica_set>/<hostname><:port>,<hostname><:port>, ...
maxSize
整型
可选。 分片的最大大小(以 MB 为单位)。 如果将maxSize设置为0 ,则 MongoDB 不限制分片的大小。
name
字符串
可选。 分片的名称。 如果未指定,MongoDB 会自动提供一个唯一名称。

addShard命令将分片配置信息存储在配置数据库中。使用admin数据库时,始终运行addShard

如果您的计算机具有不同的磁盘容量,或者您想限制某些分片的数据量,请指定maxSizemaxSize当在分片上运行 totalSizelistDatabasesmaxSize返回的 超过 的值时, 约束会阻止 负载均衡器 将数据块迁移到分片。

将分片添加到分片集群时,会影响所有现有分片collection的集群分数据块之间的数据段平衡。负载均衡器将开始迁移数据块,以便集群实现平衡。有关更多信息,请参阅集群负载均衡器

数据块迁移可能会对磁盘空间产生影响,因为源分片默认会自动存档迁移的文档。有关详细信息,请参阅moveChunk目录。

重要

不能在提供给 的种子列表中包含addShard 隐藏成员

以下命令将副本集添加为分片:

use admin
db.runCommand( { addShard: "repl0/mongodb3.example.net:27327"} )

警告

请勿使用localhost作为主机名,除非您的配置服务器也在localhost上运行。

← abortReshardCollection