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
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:
Servidor
?replicaSet=myReplicaSetNameO mongodump conecta a um membro do replica set pela URI.
Exportação
mongodump --oplogOs documentos saem coleção por coleção, junto das escritas feitas durante a cópia.
Arquivo
--archive=backup.archive --gzipTudo vai para um arquivo único comprimido, pronto para sair da VPS.
Restauração
mongorestore --oplogReplayO mongorestore grava os documentos e recria os índices pelas definições.
Momento único
oplog.bsonO mongorestore repete as escritas do oplog e deixa o banco no instante do fim da 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:
cp ou rsync.Exige parar as escritas, porque a cópia de vários arquivos não é atômica.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.
Link de parceiro da Promovaweb.