Backup do MongoDB no Databasus
O backup do MongoDB no Databasus é um arquivo lógico criado pelo mongodump com as coleções do banco selecionado. Você agenda a cópia pelo painel e usa o mongorestore para recuperar os documentos num destino compatível.
Ficha e sumário da página
- Referência técnica
- Databasus 3.70.0
- Revisão
- 14 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Um arquivo com as coleções do banco
O Databasus chama o mongodump com --archive e --gzip. As coleções seguem num único arquivo BSON comprimido, em vez de uma pasta com um arquivo por coleção. A compressão acontece dentro da ferramenta do MongoDB. Esse formato difere do SQL usado no backup do MySQL e do formato custom do PostgreSQL.
A conexão identifica o banco copiado. Você pode excluir coleções que não precisam fazer parte do arquivo, mas essa seleção limita a recuperação. Uma coleção de sessões descartáveis pode ficar fora de um backup de estudo. Os documentos necessários ao funcionamento do seu app precisam continuar incluídos e legíveis pela credencial cadastrada.
Conexão
banco · autenticaçãoA conexão identifica o banco de origem e a credencial de leitura.
Arquivo BSON
mongodump --archive --gzipAs coleções selecionadas formam um arquivo comprimido.
Destino
cifra opcionalO backup segue para o armazenamento configurado no painel.
Teste isolado
mongorestoreA restauração recupera as coleções num banco separado do app.
A versão mínima é MongoDB 4.2
O código da referência 3.70.0 aceita MongoDB a partir de 4.2 e até a linha principal 9. Servidores 4.0 são recusados porque as Database Tools distribuídas com o projeto não atendem o protocolo antigo. A enumeração interna chama a linha de 4, mas a verificação da conexão também examina a versão secundária. Por isso, escrever apenas MongoDB 4 esconderia uma restrição relevante.
As linhas 5, 6, 7, 8 e 9 também estão previstas. Isso não torna qualquer migração entre elas automaticamente válida: o formato do arquivo, as Database Tools e a versão do destino precisam ser compatíveis. Uma restauração de teste na versão planejada confirma essa combinação antes de você mudar o banco do app.
O Databasus documenta conexões com MongoDB Atlas por credenciais do MongoDB e endereço autorizado para o servidor do backup. A conexão precisa alcançar o serviço a partir da VPS do Databasus. Um endereço que funciona no seu notebook não comprova o acesso a partir do container que executa a cópia.
Autenticação e leitura das coleções
O banco de autenticação pode ser diferente do banco copiado. O campo de autenticação indica onde a credencial foi criada, enquanto o banco selecionado define as coleções do backup. Confundir esses dois nomes gera falha de login mesmo com uma senha correta. O cadastro também precisa representar as exigências de TLS e a topologia da conexão.
A implementação confere os privilégios de leitura antes do dump. O papel read no banco selecionado é uma das formas reconhecidas. Papéis amplos, como backup em admin, também são reconhecidos pelo verificador, mas concedem um alcance diferente. Você deve usar uma credencial com o alcance necessário à cópia, sem acrescentar escrita apenas para fazer o teste de conexão passar.
Quando há privilégios por coleção, a conferência compara as coleções incluídas com as permissões find. Uma coleção sem leitura pode impedir o backup. O diagnóstico precisa considerar as exclusões configuradas, porque uma coleção deixada fora do arquivo não exige a mesma leitura durante aquela execução. A inclusão futura de uma coleção também merece nova conferência.
Consistência e limites do dump
O comando da versão 3.70.0 não inclui --oplog. Ele cria o arquivo do banco selecionado com --archive e --gzip. Portanto, esse fluxo não oferece a recuperação a um ponto no tempo administrada pelo Databasus para o PostgreSQL. A frequência da agenda define a distância entre as cópias lógicas disponíveis.
Num banco que continua recebendo gravações, a consistência entre coleções exige avaliação própria. Um documento pode ser alterado enquanto outra coleção que o referencia está sendo copiada. Um dump por banco não deve ser apresentado como fotografia coordenada de um cluster fragmentado. A documentação do produto reconhece o foco em bancos individuais, por isso a recuperação de uma topologia distribuída precisa de um plano específico.
O paralelismo do dump também tem limite: a implementação permite copiar várias coleções ao mesmo tempo, com até 16. Esse campo altera o consumo de CPU, rede e leitura na origem. O melhor valor depende da duração medida e da concorrência com o app. Ele não muda o formato nem acrescenta uma cadeia incremental ao arquivo.
A restauração substitui coleções
O código chama o mongorestore com --archive, --gzip e --drop. A última opção apaga cada coleção correspondente antes de restaurá-la. A escolha do destino é, portanto, parte essencial da conferência. O primeiro teste usa um banco separado da produção e uma credencial apropriada à escrita nesse ambiente.
Quando o nome do banco de destino difere da origem, a implementação usa --nsFrom e --nsTo para remapear os nomes. Quando os nomes coincidem, usa --nsInclude para limitar as coleções. Você precisa confirmar o host e o banco selecionado antes de executar qualquer restauração, mesmo quando a tela já mostra um nome conhecido.
Depois do teste, confira as coleções e os índices recuperados. Abra o app num ambiente isolado e verifique consultas que dependem de documentos relacionados. O término do processo comprova a execução da ferramenta. A conferência funcional mostra se o conteúdo recuperado atende à aplicação.
O arquivo precisa sobreviver à VPS
O backup do MongoDB usa os destinos cadastrados no Databasus e pode receber cifra antes do envio. Guardar a cópia fora do servidor de origem permite recuperá-la quando esse servidor fica indisponível. O arquivo cifrado também exige preservar a chave secret.key fora da instalação.
As opções de agendamento e retenção definem quando copiar e quais arquivos manter. Os notificadores avisam quando uma tentativa falha. Para relacionar esse fluxo aos formatos dos outros bancos, o panorama de backups compatíveis separa a cópia lógica do MongoDB dos recursos físicos do PostgreSQL.