Restauração de backups
Sintaxe do Comando
pgsmart backup restore [FLAGS]
Flags:
-
-a, --agent=<value> ⇒ Alias, hostname ou IP do servidor onde o PgSmart Agent desejado está instalado.
-
-b, --backup=<value> [default: Todos] ⇒ Identificador do backup.
-
-h, --help ⇒ Ajuda.
-
-q, --quiet ⇒ Execução não interativa para as operações de backup (exec|info|restore). Usada em conjunto com as opções --site e --agent.
-
-s, --site=<value> [default: Todos] ⇒ Nome do ambiente de backup.
-
-t, --type=(full|diff|incr) [default: incr] ⇒ Tipo do backup.
-
full (Completo) Backup de todos os arquivos da instância.
-
diff (Diferencial) Backup dos arquivos da instância alterados desde o último backup completo.
-
incr (Incremental) Backup dos arquivos da instância alterados desde o último backup, independentemente do tipo.
-
-
--disable-archive ⇒ Indica que é para desabilitar o arquivamento dos WALs no backup restaurado. Usada em conjunto com a opção --quiet.
-
*--restore-path=<value> [default: Diretório de Dados do ambiente de backup] ⇒ Local onde será restaurado o backup.Usada em conjunto com a opção --quiet.
-
--restore-type=(delta|force) ⇒ Tipo de sobrescrita que será usada, quando existirem arquivos no local onde será restaurado o backup.Usada em conjunto com a opção --quiet.
-
delta Sobrescrever os arquivos usando checksums.
-
force Sobrescrever o diretório completamente.
-
Restauração não interativa:
pgsmart backup restore -a <agent> -site <nome-do-ambiente-de-backup> --backup <nome-do-backup> --quiet --restore-type=[delta|force]
Restauração interativa
pgsmart backup restore
-
Selecione o agente do PgSmart (ou registre um novo).
![seleciona agente](../../_images/pgsys-config-pgsmart-agent-sel.png)
-
O PgSmart fará uma verificação, validando se existe um ambiente de backup cadastrado. Em caso negativo, permitirá o cadastramento de um novo ambiente.
-
Selecione o ambiente de backup.
![seleciona ambiente de backup](../../_images/pgsys-config-backup-amb-sel.png)
O PgSmart fará a validação do ambiente, checando se o serviço do banco de dados está em execução, por exemplo. Entretanto, não impedirá que a operação prossiga (qualquer irregularidade encontrada será apenas informativa). Isto porque o restore independe da situação do ambiente. |
-
O PgSmart apresentará uma lista de backups para que seja selecionado o backup desejado. (indicando o mais recente).
-
Selecione o backup desejado.
![apresenta lista de backups](../../_images/pgsys-config-backup-restore-sel.png)
O id dos backups é criado pelo PgBackRest e sua composição é:
|
-
Após selecionar o backup, confirme se deseja utilizar o PGDATA padrão do ambiente de backup selecionado.
Caso o diretório de restauração seja o mesmo que aquele configurado para o backup, o PgSmart verificará a existência de serviços em execução na instância (para os quais será necessário confirmar a interrupção, pois a restauração só pode ser realizada com o(s) serviço(s) offline).
-
O PgSmart verificará a existência de arquivos no diretório e, no caso de identificados, será necessário informar a ação desejada.
As ações possíveis são:
-
Sobrescrever usando checksums: os arquivos do diretório destino que estão iguais aos arquivos do backup serão mantidos e restaurados apenas os arquivos diferentes. O resultado da restauração será um diretório igual ao do backup. (backup Delta com verificações realizadas por meio dos checksums)
-
Sobrescrever completamente: Todos os arquivos serão apagados e criados novamente a partir do backup. O resultado da restauração será um diretório igual ao do backup, da mesma forma.
Embora ambas opções levem ao mesmo resultado, a diferença entre as duas é tempo de restauração. A sobrescrita será mais rápida, já que apenas as diferenças serão tratadas.
-
-
-
Confirme se o arquivamento de WAL deve ser desabilitado.
-
Confirme a execução da restauração.
![confirma a restauração](../../_images/pgsys-adm-backup-rest-config.png)
![resultado da restauração](../../_images/pgsys-adm-backup-rest-resultado.png)
Caso o diretório de restauração seja diferente daquele configurado para o backup, o PgSmart verificará o diretório para restauração e, no caso de não existir, confirmará a sua criação. Se a criação não for confirmada, o PgSmart suspende a operação e retorna ao menu inicial. |
Como o arquivamento de WAL já está habilitado (o ambiente de backup já está em execução), ou seja, os logs transacionais já estão sendo gerados dentro do repositório de backup, a restauração do backup em um novo ambiente irá restaurar o estado dos parâmetros de configuração do PostgreSQL. Para evitar que os logs transacionais sejam gravados em um ambiente indesejado (no ambiente de produção quando a restauração está sendo feita em um ambiente de homologação, por exemplo), é necessário desabilitar o arquivamento de WAL. Isto fará com que o PgSmart gere os logs transacionais, reciclando-os dentro do diretório da instância, sem gerar riscos para o ambiente. |
A restauração pode ser verificada diretamente no diretório:
Para confirmar os parâmetros de configuração do restore:
|