Ir para o conteúdo
Promovaweb

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
  1. Um arquivo com as coleções do banco
  2. A versão mínima é MongoDB 4.2
  3. Autenticação e leitura das coleções
  4. Consistência e limites do dump
  5. A restauração substitui coleções
  6. O arquivo precisa sobreviver à VPS

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.

  1. Conexão

    banco · autenticação

    A conexão identifica o banco de origem e a credencial de leitura.

  2. Arquivo BSON

    mongodump --archive --gzip

    As coleções selecionadas formam um arquivo comprimido.

  3. Destino

    cifra opcional

    O backup segue para o armazenamento configurado no painel.

  4. Teste isolado

    mongorestore

    A restauração recupera as coleções num banco separado do app.

Cópia e recuperação do MongoDB no Databasus 3.70.0, conforme as ferramentas chamadas pelo código da versão.

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.

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.