Restaurar um cluster do AlloyDB Omni usando pgBackRest

Selecione uma versão da documentação:

Nesta página, mostramos como restaurar um cluster do AlloyDB Omni usando um backup criado com pgBackRest, a solução de backup de código aberto incluída no contêiner do Docker do AlloyDB Omni.

Como o AlloyDB Omni é compatível com o PostgreSQL, os comandos e as técnicas de restauração de dados descritos no manual do pgBackRest também se aplicam ao AlloyDB Omni. Nesta página, demonstramos uma seleção de tarefas comuns de recuperação, com exemplos de comandos relevantes.

Para mais informações sobre como configurar o pgBackRest para trabalhar com o AlloyDB Omni, consulte Configurar o pgBackRest para o AlloyDB Omni.

Antes de começar

Antes de configurar o AlloyDB Omni para trabalhar com o pgBackrest, é necessário ter o AlloyDB Omni instalado e em execução em um servidor controlado por você.

  • Um servidor de banco de dados de destino que executa a mesma versão principal do AlloyDB Omni que o servidor de banco de dados de origem. Para mais informações sobre como instalar o AlloyDB Omni, consulte Instalar o AlloyDB Omni.

    O servidor de destino pode ser a mesma máquina que o servidor de origem.

  • Um repositório de backup do pgBackRest que contém pelo menos um backup do banco de dados de origem do AlloyDB Omni.

  • Espaço em disco livre suficiente no servidor de destino para armazenar o banco de dados restaurado.

Visão geral

Para realizar uma restauração do AlloyDB Omni usando o pgBackRest, execute o pgbackrest restore comando. Os argumentos fornecidos ao comando variam de acordo com a situação.

Em geral, execute o comando pgbackrest restore com flags que fornecem as seguintes informações:

  • O local do arquivo pgbackrest.conf.
  • O nome do repositório de backup do pgBackRest que você quer restaurar. Esses repositórios são nomeados e definidos no arquivo pgbackest.conf.
  • O local no sistema de arquivos local para gravar os dados restaurados.
  • Um identificador do backup ou momento específico que você quer restaurar.

Ao executar os comandos pgbackrest restore em contêineres, lembre-se de usar caminhos do sistema de arquivos do ponto de vista do contêiner. Por exemplo, o caminho para o diretório de dados do AlloyDB Omni é sempre /mnt/disks/pgsql, independentemente do local no servidor host. Para mais informações, consulte Uma observação sobre caminhos do sistema de arquivos.

Realizar uma restauração pontual

Este exemplo restaura dados de um repositório do pgBackRest, nomeando um momento específico para restaurar. Se você definiu vários repositórios no arquivo pgbackrest.conf do ambiente de destino, o pgBackRest escolherá o repositório a ser restaurado com base na disponibilidade, na velocidade esperada e em outros fatores.

O exemplo pressupõe o seguinte:

  • Você tem um arquivo pgbackrest.conf localizado no nível superior do diretório de dados do AlloyDB Omni de destino. Isso disponibiliza o arquivo para o pgbackrest em contêineres como /mnt/disks/pgsql/pgbackrest.conf.

  • Você ativou backups contínuos com a configuração do pgBackRest.

  1. No ambiente de destino, realize uma restauração de PITR, especificando um carimbo de data/hora para restaurar:

    sudo docker exec pg-service pgbackrest \
      --config-path=/mnt/disks/pgsql \
      --stanza=STANZA \
      --type=time \
      --pg1-path=/mnt/disks/pgsql/data-RESTORED \
      --target="TIMESTAMP" \
      restore

    Substitua:

    • STANZA: a seção de configuração, definida pelo arquivo pgbackrest.conf, a ser aplicada a essa restauração, por exemplo, omni.

    • TIMESTAMP: o horário a ser restaurado, por exemplo, 2024-02-22 19:50:00.

  2. No ambiente de destino, interrompa o servidor de banco de dados:

    sudo alloydb database-server stop
  3. Renomeie o subdiretório data do diretório de dados como uma precaução de segurança:

    cd DATA_DIR
    sudo mv data data-OLD

    Substitua DATA_DIR pelo caminho do sistema de arquivos para o diretório de dados do AlloyDB Omni.

  4. Mova os dados restaurados para o local e limpe postgresql.auto.conf:

    sudo mv data-RESTORED data
    sudo sed -i 's|data-RESTORED|data|' data/postgresql.auto.conf
  5. Inicie o servidor de banco de dados:

    sudo alloydb database-server start

Agora é possível se conectar ao banco de dados usando psql e confirmar se os dados foram restaurados conforme o esperado. Se for o caso, você poderá excluir a cópia data-OLD do data subdiretório criado anteriormente.

Para mais informações sobre a PITR no pgBackRest, consulte Recuperação pontual. Para mais informações sobre como preparar um arquivo pgbackrest.conf para uso com o AlloyDB Omni, consulte Configurar o pgBackBack para o AlloyDB Omni.

Outras opções

O comando pgbackrest restore é muito flexível, com uma variedade de opções e recursos que podem ser controlados transmitindo diferentes opções de linha de comando. Isso inclui o seguinte:

  • Limitar uma restauração apenas a arquivos alterados.
  • Restaurar apenas bancos de dados selecionados.

Para um guia completo sobre como realizar restaurações no pgBackRest, consulte Restauração.