Ir para o conteúdo
Promovaweb

Backup do MySQL e do MariaDB

O Databasus copia o MySQL com mysqldump e o MariaDB com mariadb-dump, depois comprime o SQL com zstd nível 5. Você define a agenda e o destino no painel para guardar o SQL comprimido e restaurar o banco no estado registrado naquela cópia.

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. O SQL que o Databasus guarda
  2. Versões atendidas por esta referência
  3. Permissões e objetos incluídos
  4. Consistência durante as gravações
  5. O que a restauração executa
  6. Agenda, destino e alertas

O SQL que o Databasus guarda

O Databasus executa o mysqldump para copiar o MySQL e o mariadb-dump para copiar o MariaDB. A saída descreve tabelas e registros em SQL. O serviço comprime esse fluxo com zstd nível 5 antes de guardar o arquivo. Quando você liga a criptografia do backup, a cópia também recebe a cifra AES-256-GCM antes de chegar ao destino.

As duas ferramentas atendem produtos diferentes. O MariaDB tem recursos próprios e recebe o cliente nativo correspondente, inclusive na restauração. Uma instalação do Databasus pode acompanhar bancos dos dois produtos, mas cada conexão conserva o tipo, a versão e o banco selecionado. Você não precisa tratar o MariaDB como MySQL para colocá-lo na mesma agenda de backups.

  1. Origem

    MySQL | MariaDB

    A conexão identifica o banco e as permissões disponíveis.

  2. Cópia lógica

    mysqldump | mariadb-dump

    A ferramenta nativa escreve o SQL do banco selecionado.

  3. Arquivo

    zstd · AES-256-GCM opcional

    O serviço comprime a saída e aplica a cifra configurada.

  4. Recuperação

    mysql | mariadb

    O cliente do mesmo produto executa o SQL no destino da restauração.

Backup lógico do MySQL e do MariaDB no Databasus 3.70.0. O SQL recebe compressão fora da ferramenta de dump.

Versões atendidas por esta referência

Na versão 3.70.0, o projeto lista MySQL 5.7, 8.0, 8.4, 9 e 26. O MySQL 5.7 tem uma restrição adicional de arquitetura: a documentação oficial o atende em x86-64. Antes de colocar um banco antigo numa VPS ARM, você precisa conferir essa combinação de versão e arquitetura.

Para MariaDB, o README agrupa a compatibilidade nas linhas 5.5, 10, 11, 12 e 13. O código seleciona clientes distintos para servidores antigos e atuais. Os servidores 5.5 e 10.1 usam o cliente 10.6, os servidores intermediários usam o 12.3 e a linha 13 usa o cliente 13.0. Essa seleção pertence ao Databasus, não significa atualizar o servidor de origem.

O suporte descrito aqui é de backup lógico. O backup físico incremental e a recuperação a um ponto no tempo apresentados no backup do PostgreSQL pertencem a outro mecanismo. Um dump do MySQL ou do MariaDB volta ao estado da cópia, sem uma cadeia de WAL administrada pelo Databasus.

Permissões e objetos incluídos

A conexão de backup precisa ler os objetos selecionados. O código inclui --routines e usa --no-tablespaces para evitar a exigência global de PROCESS apenas para copiar definições de tablespaces. As permissões para rotinas podem variar com a versão e com o provedor. A credencial precisa passar pela conferência do banco cadastrado antes da primeira execução.

Os triggers e os eventos merecem uma conferência separada. Na implementação 3.70.0, --triggers só entra quando a credencial tem TRIGGER. Sem esse privilégio, o comando inclui --skip-triggers. Os eventos entram com EVENT. O MariaDB também permite excluí-los explicitamente. Portanto, uma cópia das tabelas pode terminar sem incluir esses objetos. Você precisa conferir o escopo do arquivo com as necessidades do seu app.

O formulário também permite excluir tabelas. Essa seleção altera o conteúdo recuperável: uma tabela excluída não reaparece na restauração daquele backup. Um banco auxiliar dispensável no teste pode ser necessário no app de produção. A revisão das exclusões faz parte da validação da cópia, junto com as permissões.

Consistência durante as gravações

O dump usa --single-transaction, que aproveita a fotografia transacional das tabelas compatíveis, como as do InnoDB. Isso permite copiar enquanto o app continua gravando nessas tabelas. A opção não transforma tabelas de mecanismos não transacionais numa fotografia consistente. Alterações de estrutura durante a cópia também exigem cuidado.

Uma janela de menor movimento reduz a concorrência com o app. Antes de uma migration que altera tabelas, por exemplo, você pode gerar uma cópia imediata e conferir seu resultado. A agenda regular continua separada desse disparo. As frequências e a remoção das cópias antigas estão em Agendamento e retenção.

O que a restauração executa

No MySQL, o SQL é entregue ao cliente mysql. No MariaDB, ele é entregue ao cliente mariadb. Os dois precisam de uma credencial capaz de criar e preencher os objetos no banco de destino. A credencial de leitura do backup e a credencial de restauração têm finalidades distintas.

O primeiro teste deve usar um banco isolado do app. Você confere o host, o nome do banco e a versão do destino antes de iniciar a restauração. Depois, compara tabelas, registros e objetos necessários ao funcionamento da aplicação. Um processo encerrado sem erro ainda exige esse teste funcional, principalmente quando havia exclusões ou permissões limitadas na origem.

No MariaDB com Galera, a implementação tenta desligar wsrep_on na sessão de restauração para evitar o limite de tamanho do writeset. Alguns serviços gerenciados recusam essa mudança por exigir privilégios adicionais. A opção de manter a replicação ligada atende esse caso, mas o limite do cluster continua relevante para uma restauração grande.

Agenda, destino e alertas

Os dumps participam da mesma estrutura de agendamento, destinos e notificadores dos demais bancos. Você escolhe a frequência conforme a perda de alterações que o app tolera e acompanha a duração real para evitar sobreposição com o horário seguinte. O histórico registra o tamanho e o resultado de cada tentativa.

Uma cópia externa separa o backup do disco do servidor de origem. Os destinos incluem armazenamento local, S3 e compatíveis, Azure Blob, NAS, FTP e SFTP. A chave secret.key precisa de uma cópia protegida fora da VPS para permitir a leitura dos arquivos cifrados depois da perda da instalação. Os avisos mostram falhas na execução, enquanto a restauração de teste confirma o que o arquivo consegue recuperar.

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.