Replica set no MongoDB
Um replica set é um grupo de processos mongod que mantém cópias dos mesmos bancos, com um membro primary recebendo todas as escritas e os secondaries repetindo cada mudança que ele registra no oplog. Quando o primary para de responder, os membros restantes elegem um secondary para o lugar dele, por isso o banco volta a aceitar escritas depois da queda de um membro, assim que a eleição termina.
Ficha e sumário da página
- Referência técnica
- MongoDB Community 9.0.8
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Um primary, dois secondaries e o oplog
O replica set separa os papéis pela escrita: inserções, atualizações e remoções chegam só ao primary. O oplog, onde entra cada mudança gravada, é uma coleção especial do banco local que guarda a sequência das escritas na ordem de chegada. Os secondaries leem o oplog do primary e repetem essas escritas nos próprios arquivos, de forma assíncrona, por isso um secondary pode ficar alguns instantes atrás do primary.
A formação mínima recomendada pela documentação tem três membros com cópia completa: um primary e dois secondaries. Com essa formação, o conjunto guarda duas cópias completas além do primary e continua funcionando com um membro fora do ar. O fluxo abaixo segue uma escrita até os secondaries e mostra o que acontece quando o primary para:
Escrita
insertOne()O driver manda a escrita ao primary, o único membro que aceita gravações.
Oplog
local.oplog.rsO primary grava o documento e registra a mudança no oplog.
Secondaries
replicação assíncronaCada secondary lê o oplog e aplica a mesma mudança nos próprios arquivos.
Falha
electionTimeoutMillis: 10000Sem resposta do primary por dez segundos, um secondary convoca a eleição.
Novo primary
maioria dos votosO primeiro membro a receber a maioria dos votos assume as escritas.
O replica set aceita até 50 membros, mas só 7 votam nas eleições. Os membros extras entram sem voto e servem para leituras, relatórios ou cópias dedicadas, sem mudar a matemática da maioria. Num conjunto de três membros votantes, a maioria é de dois votos, por isso a queda de um membro deixa os outros dois capazes de eleger o primary.
A eleição troca o primary
Os membros trocam sinais periódicos entre si, os heartbeats. Quando o primary fica sem contato por um tempo maior que o valor de electionTimeoutMillis, que vem com 10000 milissegundos, um secondary elegível convoca a eleição. Com as configurações padrão, a documentação indica que a mediana do tempo até o novo primary assumir não costuma passar de 12 segundos, somadas a detecção da falha e a votação.
Durante a eleição, o conjunto não aceita escritas. As leituras continuam quando o app está configurado para ler dos secondaries. Os drivers compatíveis detectam a perda do primary e repetem uma vez certas escritas, recurso chamado de escritas repetíveis, ligado por padrão. Um app com driver atualizado atravessa a troca de primary com algumas requisições mais lentas enquanto a escrita em andamento ganha uma nova tentativa quando é de um tipo repetível.
A exigência da maioria também evita dois primaries confirmando escritas ao mesmo tempo. Quando uma falha de rede divide o conjunto, o primary que enxerga só a minoria dos membros votantes deixa o posto e vira secondary. Do outro lado, o grupo que reúne a maioria elege o novo primary. Em casos raros, o primary antigo pode se considerar primary por um instante, mas só o primary atual consegue concluir uma escrita com { w: "majority" }, a confirmação de que a maioria dos membros gravou a mudança.
Árbitro ou terceiro membro com cópia
Quando o custo de um terceiro servidor com o banco inteiro pesa, a documentação aceita a formação primary, secondary e árbitro. O árbitro vota nas eleições, mas não guarda cópia nenhuma do banco, por isso ocupa pouco recurso. O preço aparece na redundância:
Primary e dois secondaries
- Formação recomendada pela documentação.
- Duas cópias completas além do primary.
- Com um secondary fora, ainda resta uma cópia além do primary.
- Três servidores com disco para o banco inteiro.
Primary, secondary e árbitro
- Aceita quando o custo de um terceiro membro com cópia pesa.
- Uma cópia completa além do primary.
- Com o secondary fora, o primary fica sem cópia nenhuma.
- Dois servidores com disco para o banco e um árbitro leve.
Como o app conecta ao replica set
O app não aponta para um servidor só: a URI de conexão lista os membros e informa o nome do conjunto pela opção replicaSet, como em mongodb://host1:27017,host2:27017,host3:27017/?replicaSet=rs0. O driver descobre qual membro é o primary, manda as escritas para ele e acompanha as trocas de papel sem mudança no código do app.
Por padrão, as leituras também vão ao primary. A preferência de leitura muda esse destino para os secondaries, o que divide a carga de relatórios, com a ressalva de que um secondary pode devolver um documento ainda sem a última atualização, por causa da replicação assíncrona. Recursos como as transações com vários documentos e os change streams exigem um replica set ou um cluster com shards. Num mongod isolado, esses recursos ficam indisponíveis.
O que o replica set não faz
O replica set copia cada mudança para os outros membros, inclusive as erradas. Um deleteMany com o filtro errado apaga os mesmos documentos no primary e, logo depois, em cada secondary, porque a remoção também entra no oplog. A redundância mantém o banco no ar quando um servidor cai, mas não guarda a versão de ontem de uma coleção. Essa versão vem de uma cópia de segurança feita à parte, assunto da página Backup e restauração.