Backup do PostgreSQL e PITR
O backup do PostgreSQL no Databasus é uma cópia lógica de um banco ou uma cópia física do cluster. Você recupera o estado registrado e, no PostgreSQL 17 e 18 com WAL contínuo, pode escolher um horário dentro do intervalo disponí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
O horário da cópia limita a recuperação
Um backup feito de madrugada recupera o banco naquele estado. Se uma alteração no app apaga registros à tarde, a cópia da madrugada não inclui o trabalho realizado durante o dia. No Databasus, o formato de backup define até qual estado do PostgreSQL você consegue voltar: o dump lógico recupera o conteúdo da cópia, enquanto o backup físico com WAL pode alcançar um horário posterior coberto pelo histórico.
Você também escolhe o tamanho do conjunto recuperado. O pg_dump copia um banco individual por uma conexão SQL. O pg_basebackup copia os arquivos de todo o cluster pelo protocolo de replicação. Para recuperar apenas um banco do servidor, essa diferença importa tanto quanto a frequência do agendamento.
O README da versão 3.70.0 declara PostgreSQL 14 a 18. O backup lógico atende esse intervalo. O backup físico desta implementação aceita somente PostgreSQL 17 e 18, com recursos nativos que permitem os incrementais. O PITR (recuperação a um ponto no tempo) pertence ao caminho físico do PostgreSQL, sem equivalência nos backups lógicos de MySQL, MariaDB ou MongoDB.
O arquivo lógico do pg_dump
O Databasus executa o pg_dump no formato custom, identificado pela opção -Fc. Esse arquivo guarda a estrutura e o conteúdo do banco para recuperação com o pg_restore. Você pode selecionar objetos durante a restauração, como uma tabela, em vez de substituir o diretório do cluster inteiro.
A compressão ocorre no próprio pg_dump. O código usa nível 5 com gzip nas versões 14 e 15 e zstd nas versões 16 a 18. A diferença acompanha a ferramenta disponível para cada versão, por isso o Databasus não produz o mesmo arquivo SQL puro usado por alguns scripts de backup.
O dump lógico também serve para migrações a versões mais novas, desde que os objetos e as extensões sejam compatíveis com o destino. Ele não promete restauração em qualquer versão. Você precisa conferir o ambiente de recuperação e as dependências do app, principalmente se o banco usa extensões que não existem no servidor novo.
O PostgreSQL fornece ao pg_dump uma visão consistente enquanto o app continua gravando. Essa característica não transforma o backup numa réplica atualizada: as mudanças posteriores à fotografia usada pelo dump ficam para outra cópia. Você escolhe a frequência conforme o período de trabalho que aceita refazer após uma perda.
Backup físico e incrementais
O backup físico completo usa o pg_basebackup para receber o cluster pela rede. A recuperação desse conjunto exige a mesma versão principal do PostgreSQL, porque o arquivo contém a estrutura física do servidor. Uma cópia do PostgreSQL 17 não vira um cluster 18 apenas pela troca da imagem Docker.
Os incrementais usam os resumos de WAL do PostgreSQL, habilitados por summarize_wal = on, para identificar os blocos alterados. O pg_basebackup --incremental transfere esses blocos em vez de copiar o cluster completo novamente. Para restaurar um incremental, você precisa preservar o backup completo e os incrementais anteriores que formam sua cadeia.
O pg_combinebackup combina essa cadeia num diretório utilizável pelo PostgreSQL. Isso reduz o volume transferido nas cópias intermediárias, mas acrescenta dependências à recuperação. Um arquivo incremental isolado não substitui a cadeia. O Databasus também permite usar somente backups físicos completos, sem ativar os incrementais.
WAL contínuo e o intervalo de PITR
O WAL (write-ahead log) registra as alterações do PostgreSQL. No Databasus, o pg_receivewal recebe esse fluxo continuamente quando a opção está habilitada. A cópia física fornece o estado inicial e os registros posteriores permitem ao PostgreSQL refazer as mudanças até o horário escolhido.
Por exemplo, uma alteração incorreta às 14h32 pode levar você a recuperar o estado das 14h31. Esse horário só é utilizável se existir uma base adequada e todos os segmentos de WAL necessários ao percurso. Uma interrupção no recebimento pode deixar parte do período sem recuperação, por isso o horário disponível depende da cobertura real mostrada pelo serviço.
O WAL contínuo é opcional. Sem ele, você não recebe a mesma possibilidade de escolher um instante entre backups. Mesmo com o fluxo habilitado, o resultado depende do WAL recebido e preservado, portanto a existência da agenda não significa perda zero de registros em qualquer falha.
Base e cadeia
completo e incrementaisO conjunto disponível precisa conter as cópias necessárias à recuperação.
Diretório do cluster
pg_combinebackupQuando há incrementais, a ferramenta combina a cadeia para preparar os arquivos.
Horário escolhido
reaplicação do WALO PostgreSQL refaz as alterações até o instante coberto selecionado.
Retomada
fim da recuperaçãoVocê confere o banco recuperado e a conexão do app ao destino.
Conexão e permissões da origem
O backup lógico usa uma credencial de leitura, com permissão para acessar os objetos incluídos no dump. A credencial do app costuma ter permissões de escrita e não deve ser reaproveitada como se fosse uma credencial dedicada ao backup. O Databasus confere os privilégios e informa as permissões que precisam de ajuste.
O backup físico exige uma credencial com REPLICATION e acesso pelo protocolo de replicação. Uma conexão SQL bem-sucedida não comprova que esse outro acesso está liberado. Em serviços gerenciados, você precisa conferir as permissões e os recursos oferecidos pelo provedor para aquela versão do PostgreSQL.
O serviço executa essas ferramentas no host do Databasus, sem instalar um agente no servidor do banco. O túnel SSH é uma alternativa para alcançar uma rede privada. Instalações antigas com backups do agente removido exigem atenção à migração: a documentação mantém a versão 3.42.0 como referência daquele modelo anterior.
Recuperar também exige guardar a chave
O painel fornece instruções e um script para a recuperação física. No formato lógico, você usa o arquivo e o pg_restore com as opções adequadas ao destino. A retomada do app exige conferir o banco recuperado, por isso um teste isolado permite observar o resultado sem substituir o banco em uso.
Se a criptografia estiver habilitada, preserve também uma cópia externa do secret.key da instalação. A recuperação manual de um arquivo cifrado precisa dessa chave, inclusive quando o host do Databasus foi perdido. A verificação de restauração testa as cópias e a página Agendamento e retenção explica como manter o histórico necessário.