Menu Docs

Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

replSetSyncFrom

Nesta página

  • Descrição
  • Sintaxe
  • Campos de comando
  • Comportamento

Descrição

replSetSyncFrom

Substitui temporariamente o destino de sincronização padrão para o mongod atual . Esta operação é útil para testar padrões diferentes e em situações em que um membro do conjunto não está replicando a partir do host desejado.

Dica

Em mongosh, este comando também pode ser executado por meio do método auxiliar rs.syncFrom() .

Os métodos auxiliares são convenientes para os usuários mongosh , mas podem não retornar o mesmo nível de informações que os comandos do banco de dados. Nos casos em que a conveniência não for necessária ou os campos de retorno adicionais forem necessários, use o comando de banco de dados.

Execute replSetSyncFrom no banco de dados admin .

Sintaxe

O comando tem a seguinte sintaxe:

db.adminCommand(
   {
     replSetSyncFrom: "hostname<:port>"
   }
 )

Campos de comando

O comando usa o seguinte campo:

Campo
Tipo
Descrição
replSetSyncFrom
string

O nome e o número da porta do nó do conjunto de réplicas do qual este nó deve replicar. Use o formulário [hostname]:[port] .

Membros do conjunto de réplicas com 1 vote não podem ser sincronizados a partir de membros com 0 votes.

Comportamento

Lógica de sincronização

Se uma operação de sincronização inicial estiver em andamento ao executar o replSetSyncFrom, o replSetSyncFrom interromperá a sincronização inicial em andamento e reiniciará o processo de sincronização com o novo destino.

Modifique apenas a lógica de sincronização padrão conforme necessário e sempre tenha cuidado.

Alvo

O membro de quem sincronizar deve ser uma fonte válida para dados no conjunto. Para sincronizar de um membro, o membro deve:

  • Tenha dados. Não pode ser um árbitro, no modo de inicialização ou recuperação, e deve ser capaz de responder a queries de dados.

  • Seja acessível.

  • Seja um membro do mesmo conjunto na configuração do conjunto de réplicas.

  • Construa índices com a configuração members[n].buildIndexes.

  • Outro nó do conjunto, para evitar a sincronização dele mesmo.

Se você tentar replicar de um membro que está mais de 10 segundos atrás do membro atual, mongod registrará um aviso, mas ainda replicará do membro atrasado. Consulte também Controle de fluxo e atraso de replicação.

Persistência

replSetSyncFrom fornece uma substituição temporária do comportamento padrão. mongod será revertido para o comportamento de sincronização padrão nas seguintes situações:

  • A instância do mongod é reiniciada.

  • A conexão entre o mongod e o destino de sincronização é fechada.

  • Se o destino da sincronização cair mais de 30 segundos atrás de outro membro do conjunto de réplicas.

Para obter mais informações sobre o uso de replSetSyncFrom, consulte Configurar o destino de sincronização de um secundário.

← replSetStepDown
Comandos de fragmentação →

Nesta página