rs.remove()

Definition定义

rs.remove(hostname)

Removes the member described by the hostname parameter from the current replica set. 从当前复制副本集中删除由hostname参数描述的成员。This function will disconnect the shell briefly and forces a reconnection as the replica set renegotiates which member will be primary. As a result, the shell will display an error even if this command succeeds.此函数将短暂断开shell的连接，并在副本集重新协商哪个成员将是primary时强制重新连接。因此，即使此命令成功，shell也会显示错误。

The rs.remove() method has the following parameter:rs.remove()方法具有以下参数：

Parameter参数	Type类型	Description描述
hostname	string	The hostname of a system in the replica set.复制副本集中系统的主机名。

Note

Before running the rs.remove() operation, it is good practice to shut down the replica set member that you are removing.在运行rs.remove()操作之前，最好关闭要删除的副本集成员。

Behavior行为

By default, replica set members wait for 5 minutes before dropping connections to the removed member. 默认情况下，副本集成员要等待5分钟，然后才能断开与已删除成员的连接。In sharded replica sets, you can modify this timeout using the ShardingTaskExecutorPoolHostTimeoutMS server parameter.在分片副本集中，可以使用ShardingTaskExecutorPoolHostTimeoutMS服务器参数修改此超时。

db.adminCommand(
  {
    "dropConnections" : 1,
    "hostAndPort" : [
      "<hostname>:<port>"
    ]
  }
)

Replace <hostname> with the hostname of the removed member and <port> with the port the mongod listened on.将<hostname>替换为已删除成员的主机名，将<port>替换为mongod侦听的端口。