Restauração de backups

Sintaxe do Comando

Terminal input

  pgsmart backup restore [Flags]

Flags:

• -a, --agent=<agent> => Alias, hostname ou IP do servidor onde o PgSmart Agent desejado está instalado.
• -b, --backup=<valor> => Identificador do backup.[default: Todos]
• -h, --help => Ajuda.
• -j, --job=<value> => identificador da tarefa de backup/restore.
• -o, --only-info => indica para mostrar apenas as informações dos sites de backups. Usada em conjunto com a opção --quiet.
• -p, --no-page-info => Indica que não é para paginar as informações dos sites de backups. Usada em conjunto com a opção --quiet.
• -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> => Nome do site de backups.[default: Todos].
• --disable-archive => Indica que é para desabilitar o arquivamento dos WALs no backup restaurado. Usada em conjunto com a opção --quiet.
• --restore-path=<value>=> Local onde será restaurado o backup.Usada em conjunto com a opção --quiet. [default: Diretório de dados do site de backups].
• --restore-type=(delta|force) => Tipo de sobrescrita que será usada, quando existirem arquivos no local onde será restaurado. Usada em conjunto com a opção --quiet.
  • delta Sobrescrever os arquivos usando checksums.
  • force Sobrescrever o diretório completamente.

Execução Não-Interativa

Instruções

Terminal input

  pgsmart backup restore -a <agente> --site <nome-do-site-de-backup> --backup <nome-do-backup> --quiet --restore-type=[delta|force]

Figura 1 - Restauração de Backup

Vídeo

Carregando...

Execução Interativa

Terminal input

  pgsmart backup restore

Instruções

1. Selecione o Agente do PgSmart desejado (ou Registrar novo Agente).

2. O PgSmart fará uma verificação, validando se existe um site de backup cadastrado. Em caso negativo, permitirá o cadastramento de um novo site.

3. Selecione o site de backup.

   3.1. O PgSmart apresentará uma lista de backups para que seja selecionado o backup desejado. (indicando o mais recente).

   nota

   O PgSmart fará a validação do site, 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 site.

4. Selecione o backup desejado.

   nota

   O id dos backups é criado pelo pgBackRest e sua composição é:

   • Um prefixo indicando o timestamp (data e hora) da criação do backup no formato aammdd-hhmmss.

   • Um sufixo "f", "i" ou "d", indicando o tipo do backup (full, diferencial, incremental).

   • Caso o backup seja do tipo incremental ou diferencial, antes do id do backup corrente, existirá o id do backup completo que o mesmo deriva.

   Exemplo:

   • (full) 20230520-130807F

   • (incr) 20230520-130807F_20230520-130816I

   • (diff) 20230520-130807F_20230523-180002D

   • (full) 20230523-192605F (Backup mais recente)

5. Após selecionar o backup, confirme se deseja utilizar o PGDATA padrão do site de backup selecionado.

   nota

   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).

6. O PgSmart verificará a existência de arquivos no diretório e, no caso de identificados, será necessário informar a ação desejada.

   nota

   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.

7. Confirme se o arquivamento de WAL deve ser desabilitado.

8. Confirme a execução da restauração.

   

   Figura 2 - Restauração de Backup

Vídeo

Carregando...

Notas Finais

nota

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.

nota

• Como o arquivamento de WAL já está habilitado (o site 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 site 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.

nota

A restauração pode ser verificada diretamente no diretório:

Terminal input

  cd /var/lib/pgsql/15/datann

Para confirmar os parâmetros de configuração do restore:

Terminal input

  cat postgresql.auto.conf