rs.remove() (método mongosh)

Definição

rs.remove(hostname)

Remove o membro descrito pelo parâmetro hostname do conjunto de réplica 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 tem o seguinte rs.remove() 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ê está 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

Preocupação global com gravação

A remoção de um nó altera o número de nós votantes no conjunto de réplicas, o que pode alterar o preocupação de gravação padrão implícito.

Você deve definir explicitamente o preocupação de gravação padrão global antes de tentar reconfigurar um conjunto de réplicas com uma configuração que altere o preocupação de gravação padrão implícito. Para definir a preocupação de gravação padrão global, use o setDefaultRWConcern comando.

A remoção espera até que uma maioria dos membros instale a configuração da réplica

rs.remove() executa o replSetReconfig comando com uma configuração que omite o membro removido. O método espera até que a maioria dos membros do conjunto de réplicas votantes instale a nova configuração de réplica antes de retornar o sucesso. Um membro votante é qualquer membro do conjunto de members[n].votes 1réplicas em que é, incluindo árbitros. Para saber como os membros do conjunto de réplicas instalam uma nova configuração, consulte A reconfiguração aguarda até que uma maioria dos membros instale a configuração da réplica.

rs.remove() não aceita um limite de maxTimeMS. Se a maioria dos membros votantes nunca instalar a nova configuração, a operação aguardará indefinidamente.

Conexões com o membro removido

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.

Voltar

rs.reconfigForPSASet

rs.status