rs.remove() (método mongosh)

Definição

rs.remove(hostname)

Remove o membro descrito pelo parâmetro hostname doconjunto de réplicas do atual. Essa função desconectará o shell brevemente e forçará uma reconexão à medida que o conjunto de réplicas renegociar qual membro será o principal. Como resultado, o shell exibirá um erro mesmo se este comando for bem-sucedido.

O método rs.remove() tem o seguinte parâmetro:

Parâmetro	Tipo	Descrição
hostname	string	O nome do host de um sistema no conjunto de réplicas.

Observação

Antes de executar a operação rs.remove(), é uma boa prática desligar o membro do conjunto de réplicas que você estiver removendo.

Compatibilidade

Esse método está disponível em implantações hospedadas nos seguintes ambientes:

• MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB

• MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB

Comportamento

Por padrão, os membros do conjunto de réplicas aguardam 5 minutos antes de descartar conexões com o membro removido. Em conjuntos de réplicas fragmentadas, você pode modificar esse tempo limite usando o parâmetroShardingTaskExecutorPoolHostTimeoutMS server.

Para descartar imediatamente todas as conexões de saída do conjunto de réplicas para o nó removido, execute o comando administrativo dropConnections em cada nó restante no conjunto de réplicas:

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

Substitua <hostname> pelo nome do host do membro removido e <port> pela porta em que o mongod ouviu.