Ir para o conteúdo
Promovaweb

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
  1. Um primary, dois secondaries e o oplog
  2. A eleição troca o primary
  3. Árbitro ou terceiro membro com cópia
  4. Como o app conecta ao replica set
  5. O que o replica set não faz

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:

  1. Escrita

    insertOne()

    O driver manda a escrita ao primary, o único membro que aceita gravações.

  2. Oplog

    local.oplog.rs

    O primary grava o documento e registra a mudança no oplog.

  3. Secondaries

    replicação assíncrona

    Cada secondary lê o oplog e aplica a mesma mudança nos próprios arquivos.

  4. Falha

    electionTimeoutMillis: 10000

    Sem resposta do primary por dez segundos, um secondary convoca a eleição.

  5. Novo primary

    maioria dos votos

    O primeiro membro a receber a maioria dos votos assume as escritas.

O ciclo de um replica set de três membros: a escrita chega ao primary, vai para o oplog e é repetida nos secondaries. Quando o primary some por mais de dez segundos, os membros restantes elegem um novo primary pela maioria dos votos.

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.