Ir para o conteúdo
Promovaweb

Backup e restauração do MongoDB

Um documento apagado por engano some de todos os membros do replica set, por isso a restauração depende de uma cópia feita à parte. O mongodump e o mongorestore são as duas ferramentas das MongoDB Database Tools que fazem a cópia lógica de um servidor MongoDB pelo terminal do sistema, fora do mongosh. O mongodump exporta cada coleção num arquivo BSON acompanhado dos metadados e das definições de índice, por isso o dump fica menor do que os arquivos do banco e o mongorestore reconstrói cada índice a partir da definição guardada.

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. O que vai para dentro do dump
  2. O oplog deixa a cópia num instante só
  3. O que a restauração exige
  4. Os outros métodos de backup

O que vai para dentro do dump

Por padrão, o mongodump grava numa pasta chamada dump/, com uma subpasta para cada banco. Dentro dela, cada coleção vira dois arquivos. O .bson guarda os documentos na mesma codificação que o servidor usa, enquanto o .metadata.json guarda as opções da coleção e as definições dos índices. As views ganham só o arquivo de metadados, porque o conteúdo delas sai de outras coleções. Os índices em si não entram no dump, só a definição de cada um.

O formato do dump muda com duas opções. Com --archive, o dump inteiro vira um arquivo só, mais simples de mover para outro servidor. A documentação registra que a gravação em arquivo único pode ter desempenho melhor do que a pasta. Com --gzip, os arquivos saem comprimidos, com as extensões .bson.gz e .metadata.json.gz, ou o arquivo único sai comprimido inteiro. As duas opções combinam entre si.

O ciclo completo, do servidor ao arquivo e de volta, aparece no fluxo abaixo, com a cópia consistente de um membro de replica set do exemplo oficial:

  1. Servidor

    ?replicaSet=myReplicaSetName

    O mongodump conecta a um membro do replica set pela URI.

  2. Exportação

    mongodump --oplog

    Os documentos saem coleção por coleção, junto das escritas feitas durante a cópia.

  3. Arquivo

    --archive=backup.archive --gzip

    Tudo vai para um arquivo único comprimido, pronto para sair da VPS.

  4. Restauração

    mongorestore --oplogReplay

    O mongorestore grava os documentos e recria os índices pelas definições.

  5. Momento único

    oplog.bson

    O mongorestore repete as escritas do oplog e deixa o banco no instante do fim da cópia.

O ciclo de uma cópia consistente: o mongodump lê o servidor e o oplog, grava um arquivo único comprimido e o mongorestore devolve os documentos, recria os índices e repete as escritas feitas durante a cópia.

O oplog deixa a cópia num instante só

Um dump de um banco que continua recebendo escritas mistura momentos diferentes. A primeira coleção sai com o estado do início e a última com o estado do fim. Um documento atualizado no meio do caminho pode aparecer numa versão enquanto o documento ligado a ele aparece em outra. A opção --oplog corrige essa diferença num membro de replica set: o mongodump também guarda as entradas do oplog gravadas durante a exportação, num arquivo oplog.bson. Na restauração, o mongorestore --oplogReplay repete essas entradas. Com isso, o banco restaurado fica como estava num único momento.

A opção funciona só contra um membro de replica set, sem suporte no mongos de um cluster com shards. Ela também não combina com --db, --collection nem --query, porque a cópia consistente exige o dump completo do membro. O dump com --oplog ainda falha quando um cliente executa certas ações durante a cópia, como renameCollection, uma agregação com $out ou a criação e a alteração de usuários e papéis. Num mongod isolado, sem replica set, não existe oplog, por isso a consistência depende de pausar as escritas durante a cópia.

O que a restauração exige

O arquivo BSON carrega o formato da versão do servidor de origem. A documentação limita a restauração a servidores com a mesma versão principal ou a mesma versão de compatibilidade de recursos, a FCV, do servidor de origem. Um dump tirado de um servidor 8.0 só volta para um servidor 9.0 que ainda esteja com a FCV 8.0.

A senha escrita na linha de comando também fica exposta: passada dentro da --uri, ela pode aparecer em alguns sistemas para outros usuários que rodam o ps. A documentação recomenda o prompt de senha ou um arquivo de configuração passado em --config, que guarda as credenciais fora da linha de comando e fora do histórico do shell.

Os outros métodos de backup

A página oficial de backup indica o mongodump para implantações pequenas e descreve os outros métodos para servidores maiores ou com outras exigências de recuperação:

MétodoComo copiaLimite
mongodump e mongorestoreExporta documentos e definições de índice em BSON.Indicado para implantações pequenas. A restauração reconstrói os índices.
Snapshot do sistema de arquivosFotografa o volume do banco num instante exato.Exige o journal no mesmo volume lógico dos arquivos do banco.
Cópia dos arquivosCopia a pasta do banco com cp ou rsync.Exige parar as escritas, porque a cópia de vários arquivos não é atômica.
Cloud Manager e Ops ManagerLê o oplog e cria snapshots com recuperação a um ponto no tempo.Exigem o MongoDB Enterprise ou a assinatura Enterprise Advanced.

O snapshot e a cópia dos arquivos guardam os índices junto com os documentos, o que deixa a cópia maior e a restauração mais curta, sem reconstrução de índice. O mongodump ocupa menos espaço e roda por cima da conexão comum, sem acesso ao disco do servidor. Para um banco de estudo numa VPS, com algumas coleções e poucos gigabytes, o dump comprimido em arquivo único cabe bem. Para um banco que cresce, o tempo de restauração com reconstrução de todos os índices pesa na escolha.

O mongodump e o mongorestore vêm de um repositório separado do servidor, o mongodb/mongo-tools, publicado sob a Apache License 2.0. A licença do servidor e a de cada peça do MongoDB fecham o portal na página Community Edition e licença SSPL.

Continue na comunidade

Leve ao Discord da Promovaweb a consulta que lê a coleção inteira ou o replica set que não elege um primary. Com a saída do explain na conversa, a comunidade compara o seu caso com bancos parecidos.

Uma VPS para o seu MongoDB

O mongod guarda os arquivos de todos os bancos no disco da VPS. A VPS da StayCloud em São Paulo vem com acesso root e disco NVMe para o MongoDB de estudo.

Ver a VPS da StayCloud

Link de parceiro da Promovaweb.