Descripción

pg_rewind es una herramienta para sincronizar un clúster de PostgreSQL con otra copia del mismo clúster, después de que las líneas de tiempo (timelines) de los clústeres se hayan bifurcado. Un escenario típico es volver a poner en línea un antiguo servidor primario después de una conmutación por error (failover) como un servidor en espera (standby) que sigue al nuevo primario.

Después de una rebobinación (rewind) exitosa, el estado del directorio de datos de destino es análogo a una copia de seguridad base (base backup) del directorio de datos de origen. A diferencia de realizar una nueva copia de seguridad base o usar una herramienta como rsync, pg_rewind no requiere comparar o copiar bloques de relación que no hayan cambiado en el clúster. Solo se copian los bloques cambiados de los archivos de relación existentes; todos los demás archivos, incluidos los nuevos archivos de relación, los archivos de configuración y los segmentos WAL, se copian en su totalidad. Por lo tanto, la operación de rebobinado es significativamente más rápida que otros enfoques cuando la base de datos es grande y solo una pequeña fracción de los bloques difiere entre los clústeres.

pg_rewind examina los historiales de líneas de tiempo de los clústeres de origen y destino para determinar el punto en el que se bifurcaron, y espera encontrar WAL en el directorio pg_wal del clúster de destino que llegue hasta el punto de bifurcación. El punto de bifurcación se puede encontrar en la línea de tiempo de destino, en la línea de tiempo de origen o en su ancestro común. En el escenario típico de conmutación por error en el que el clúster de destino se apagó poco después de la bifurcación, esto no es un problema, pero si el clúster de destino se ejecutó durante mucho tiempo después de la bifurcación, es posible que sus archivos WAL antiguos ya no estén presentes. En este caso, puedes copiarlos manualmente desde el archivo WAL al directorio pg_wal, o ejecutar pg_rewind con la opción -c para recuperarlos automáticamente desde el archivo WAL. El uso de pg_rewind no se limita a la conmutación por error; por ejemplo, un servidor en espera puede promoverse, ejecutar algunas transacciones de escritura y luego rebobinarse para convertirse en un servidor en espera de nuevo.

Después de ejecutar pg_rewind, debe completarse la reproducción de WAL para que el directorio de datos quede en un estado consistente. Cuando el servidor de destino se inicie de nuevo, entrará en recuperación de archivos (archive recovery) y reproducirá todo el WAL generado en el servidor de origen desde el último punto de control (checkpoint) antes del punto de bifurcación. Si parte del WAL ya no estaba disponible en el servidor de origen cuando se ejecutó pg_rewind y, por lo tanto, no pudo ser copiado por la sesión de pg_rewind, debe estar disponible cuando se inicie el servidor de destino. Esto se puede hacer creando un archivo recovery.signal en el directorio de datos de destino y configurando un comando adecuado con restore_command en postgresql.conf.

pg_rewind requiere que el servidor de destino tenga habilitada la opción wal_log_hints en postgresql.conf o las sumas de comprobación de datos (checksums) habilitadas cuando el clúster se inicializó con initdb (el valor predeterminado). full_page_writes también debe estar configurado en on, aunque está habilitado por defecto.

Opciones

pg_rewind acepta los siguientes argumentos de línea de comandos:

Entorno

Cuando se utiliza la opción --source-server, pg_rewind también utiliza las variables de entorno admitidas por libpq (véase Section 32.15).

La variable de entorno PG_COLOR especifica si se debe usar color en los mensajes de diagnóstico. Los valores posibles son always, auto y never.

Notas

Al ejecutar pg_rewind utilizando un clúster en línea como origen, se puede utilizar un rol que tenga suficientes permisos para ejecutar las funciones utilizadas por pg_rewind en el clúster de origen en lugar de un superusuario. Aquí se muestra cómo crear dicho rol, llamado aquí rewind_user:

CREATE USER rewind_user LOGIN;
GRANT EXECUTE ON function pg_catalog.pg_ls_dir(text, boolean, boolean) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_stat_file(text, boolean) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_read_binary_file(text) TO rewind_user;
GRANT EXECUTE ON function pg_catalog.pg_read_binary_file(text, bigint, bigint, boolean) TO rewind_user;