Menu Docs
Página inicial do Docs
/
Manual do MongoDB
/
Referência
/
Comandos de banco de dados
/
Replicação

replSetSyncFrom

Nesta página

  • Descrição
  • Compatibilidade
  • 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, esse comando também pode ser executado por meio do método auxiliar rs.syncFrom().

Os métodos auxiliares são práticos 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 praticidade 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 .

Compatibilidade

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

  • MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem

Importante

Este comando não é suportado em M0, M2, M5 e M10+ clusters. Para obter mais informações, consulte Comandos não suportados.

  • 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

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 autogerenciado.

Voltar

replSetStepDown

Próximo

Fragmentação