Restaurar un clúster de AlloyDB Omni con pgBackRest

Selecciona una versión de la documentación:

En esta página se explica cómo restaurar un clúster de AlloyDB Omni mediante una copia de seguridad creada con pgBackRest, la solución de copia de seguridad de código abierto incluida en el contenedor Docker de AlloyDB Omni.

Como AlloyDB Omni es compatible con PostgreSQL, los comandos y las técnicas de restauración de datos que se describen en el manual de pgBackRest también se aplican a AlloyDB Omni. En esta página se muestra una selección de tareas de recuperación habituales, con ejemplos de comandos relevantes.

Para obtener más información sobre cómo configurar pgBackRest para que funcione con AlloyDB Omni, consulta el artículo Configurar pgBackRest para AlloyDB Omni.

Antes de empezar

Antes de configurar AlloyDB Omni para que funcione con pgBackrest, debes tener AlloyDB Omni instalado y en ejecución en un servidor que controles.

  • Un servidor de base de datos de destino que ejecute la misma versión principal de AlloyDB Omni que el servidor de base de datos de origen. Para obtener más información sobre cómo instalar AlloyDB Omni, consulta Instalar AlloyDB Omni.

    El servidor de destino puede ser el mismo que el de origen.

  • Un repositorio de copias de seguridad de pgBackRest que contenga al menos una copia de seguridad de la base de datos de AlloyDB Omni de origen.

  • Suficiente espacio libre en el disco del servidor de destino para alojar la base de datos restaurada.

Información general

Para realizar una restauración de AlloyDB Omni con pgBackRest, ejecuta el comando pgbackrest restore. Los argumentos que proporciones al comando variarán en función de tu situación.

Por lo general, se ejecuta el comando pgbackrest restore con marcas que proporcionan la siguiente información:

  • La ubicación de tu archivo pgbackrest.conf.
  • El nombre del repositorio de copias de seguridad de pgBackRest del que quieres restaurar los datos. Estos repositorios se denominan y definen en el archivo pgbackest.conf.
  • Ubicación del sistema de archivos local en la que se escribirán los datos restaurados.
  • Identificador de la copia de seguridad o del momento concreto a partir del cual quieres restaurar los datos.

Cuando ejecutes los comandos de pgbackrest restore en contenedores, recuerda usar las rutas del sistema de archivos desde el punto de vista del contenedor. Por ejemplo, la ruta al directorio de datos de AlloyDB Omni siempre es /mnt/disks/pgsql, independientemente de su ubicación en el servidor host. Para obtener más información, consulta Nota sobre las rutas del sistema de archivos.

Realizar una restauración a un momento dado

En este ejemplo se restauran datos de un repositorio de pgBackRest y se indica un momento concreto a partir del cual se restauran los datos. Si has definido varios repositorios en el archivo pgbackrest.conf del entorno de destino, pgBackRest elegirá el repositorio desde el que restaurar en función de la disponibilidad, la velocidad esperada y otros factores.

En el ejemplo se da por supuesto lo siguiente:

  • Tienes un archivo pgbackrest.conf situado en el nivel superior del directorio de datos de AlloyDB Omni de destino. De esta forma, el archivo estará disponible para el pgbackrest en contenedores como /mnt/disks/pgsql/pgbackrest.conf.

  • Has habilitado las copias de seguridad continuas con tu configuración de pgBackRest.

  1. En el entorno de destino, realiza una restauración PITR y especifica una marca de tiempo desde la que 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

    Haz los cambios siguientes:

    • STANZA: la estrofa de configuración, definida por el archivo pgbackrest.conf, que se aplicará a esta restauración. Por ejemplo, omni.

    • TIMESTAMP: la hora de la que se va a restaurar (por ejemplo, 2024-02-22 19:50:00).

  2. En el entorno de destino, detén el servidor de la base de datos:

    sudo alloydb database-server stop

  3. Cambia el nombre del subdirectorio data de tu directorio de datos como medida de seguridad:

    cd DATA_DIR
sudo mv data data-OLD

    Sustituye DATA_DIR por la ruta del sistema de archivos al directorio de datos de AlloyDB Omni.

  4. Mueve los datos restaurados a su ubicación y limpia postgresql.auto.conf:

    sudo mv data-RESTORED data
sudo sed -i 's|data-RESTORED|data|' data/postgresql.auto.conf

  5. Inicia el servidor de la base de datos:

    sudo alloydb database-server start

Ahora puede conectarse a su base de datos mediante psql y confirmar que los datos se han restaurado correctamente. Si es así, puedes eliminar la data-OLDcopia del subdirectorio data que has creado antes.

Para obtener más información sobre la recuperación a un momento dado en pgBackRest, consulta Point-in-Time Recovery (Recuperación a un momento dado). Para obtener más información sobre cómo preparar un archivo pgbackrest.conf para usarlo con AlloyDB Omni, consulta Configurar pgBackRest para AlloyDB Omni.

Otras opciones

El comando pgbackrest restore es muy flexible y ofrece una serie de opciones y funciones que puedes controlar mediante diferentes opciones de línea de comandos. Entre ellas, se incluyen las siguientes:

  • Limitar la restauración solo a los archivos modificados.
  • Restaurar solo las bases de datos seleccionadas.

Para obtener una guía completa sobre cómo realizar restauraciones en pgBackRest, consulta Restaurar.