Pular para o conteúdo principal
Versão Next

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 pretendido está instalado.
  • -b, --backup=<valor> => Identificador do backup. [default: Todos]
  • -h, --help => Ajuda
  • -j, --job=<valor> => Identificador da tarefa de backup/restauração.
  • -o, --only-info => Indica que deve mostrar apenas as informações dos sites de backup. Utilizada com a opção --quiet.
  • -p, --no-page-info => Indica que não deve paginar as informações dos sites de backup. Utilizada com a opção --quiet.
  • -q, --quiet => Execução não interativa para operações de backup (exec|info|restore). Utilizada com as opções --site e --agent.
  • -s, --site=<valor> => Nome do site de backup. [default: Todos]
  • --disable-archive => Desativa o arquivamento de WALs no backup restaurado. Utilizada com a opção --quiet.
  • --restore-path=<valor> => Local onde será restaurado o backup. [default: Diretório de dados do site de backup] Utilizada com a opção --quiet.
  • --restore-type=(delta|force) => Tipo de sobrescrita utilizado quando existirem ficheiros no local de restauração. Utilizada com a opção --quiet.
    • delta: Sobrescrever utilizando checksums.
    • force: Sobrescrever completamente o diretório.
Execução Não-Interativa
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
Figura 1 - Restauração de Backup
Execução Interativa
Terminal input
  pgsmart backup restore

  1. Selecione o Agente do PgSmart pretendido (ou Registar um novo Agente).

  2. O PgSmart irá validar se existe um site de backup registado. Em caso negativo, permitirá o registo dum novo site.

  3. Selecione o site de backup.

3.1. O PgSmart apresentará uma lista de backups disponíveis para seleção, destacando o mais recente.

nota

O PgSmart validará o site, verificando, por exemplo, se o serviço da base de dados está em execução. No entanto, mesmo com irregularidades, o processo de restauração continuará (informação apenas). A restauração é independente do estado do site.

  1. Selecione o backup desejado.
nota

Os IDs dos backups são gerados pelo pgBackRest e são compostos por:

  • Um prefixo com timestamp (data e hora no formato aammdd-hhmmss).
  • Um sufixo "F", "I" ou "D", indicando backup completo, incremental ou diferencial.
  • Nos backups incrementais/diferenciais, o ID do backup completo antecede o ID atual.

Exemplos:

  • (completo) 20230520-130807F
  • (incremental) 20230520-130807F_20230520-130816I
  • (diferencial) 20230520-130807F_20230523-180002D
  • (completo) 20230523-192605F (Backup mais recente)

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

    nota

    Caso o diretório de restauração seja o mesmo configurado para o backup, o PgSmart irá verificar se existem serviços ativos e solicitará a confirmação para os interromper, visto que a restauração requer que todos os serviços estejam offline.

  2. O PgSmart verificará se já existem ficheiros no diretório de destino. Se existirem, será necessário definir a ação de sobrescrita.

nota

As ações possíveis são:

  • Sobrescrever utilizando checksums: apenas os ficheiros diferentes serão restaurados, mantendo os que são idênticos.
  • Sobrescrever completamente: o diretório será apagado e restaurado na totalidade.

Ambas as opções garantem o mesmo resultado, mas a sobrescrita por checksums é mais rápida.

  1. Confirme se deseja desativar o arquivamento de WALs.

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

Figura 2 - Restauração de Backup
Figura 2 - Restauração de Backup
Notas Finais
nota

Caso o diretório de restauração seja diferente do configurado para o backup, o PgSmart solicitará confirmação para criar o novo diretório. Se não for autorizado, a operação será cancelada e o usuário retornará ao menu principal.

nota

  • Como o arquivamento de WAL já está ativado (o site de backup está em execução), a restauração dum backup para um novo site restaurará também os parâmetros de configuração do PostgreSQL.

  • Para evitar que logs transacionais sejam gravados num ambiente indesejado (por exemplo, em produção ao restaurar num ambiente de homologação), é necessário desativar o arquivamento de WAL. Assim, os logs serão reciclados localmente, sem 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 restaurados:

Terminal input
    cat postgresql.auto.conf