archive_mode y archive_command

archive_mode habilita el archivado de WAL en el primario. archive_command envía cada segmento de WAL completado a almacenamiento duradero para PITR y seguridad de recuperación de standbys.

Receta

Directorio de archivo local para el laboratorio; patrón S3 o NFS para producción.

ALTER SYSTEM SET archive_mode = on;
ALTER SYSTEM SET archive_command =
  'test ! -f /mnt/wal_archive/%f && cp %p /mnt/wal_archive/%f';
ALTER SYSTEM SET archive_timeout = '300s';
-- reiniciar PostgreSQL para habilitar archive_mode

# Verificar que el archiver está en ejecución
psql -c "SELECT * FROM pg_stat_archiver;"
ls -l /mnt/wal_archive/ | tail

Cuándo usar esto: Cualquier clúster PostgreSQL autoalojado 18.4 que requiera PITR o retención de WAL sin pgBackRest.

Ejemplo de funcionamiento

Patrones de producción: Montaje NFS, rclone a S3 e integración con pgBackRest:

# archive_command a través de script (copia atómica)
# /usr/local/bin/archive_wal.sh
#!/usr/bin/env bash
set -euo pipefail
WAL_PATH="$1"
WAL_NAME="$2"
DEST="/mnt/wal_archive/${WAL_NAME}"
test ! -f "$DEST" && cp "$WAL_PATH" "$DEST"
aws s3 cp "$DEST" "s3://prod-pg-wal/${WAL_NAME}" --only-if-different

-- Equivalentes de postgresql.conf
-- archive_mode = on
-- archive_command = '/usr/local/bin/archive_wal.sh %p %f'
-- wal_level = replica  (mínimo)
 
SELECT archived_count, failed_count, last_failed_wal, last_failed_time
FROM pg_stat_archiver;

# Forzar el cambio de segmento para probar la ruta de archivo
psql -c "SELECT pg_switch_wal();"
sleep 2
psql -c "SELECT last_archived_wal, last_archived_time FROM pg_stat_archiver;"

Lo que esto demuestra:

• archive_command debe devolver 0 como código de salida en caso de éxito; cualquier valor distinto de cero incrementa failed_count.
• test ! -f previene errores de sobrescritura en reintentos.
• archive_timeout fuerza el cambio de WAL en sistemas de bajo tráfico para que los archivos lleguen a tiempo.

Análisis detallado

Placeholders de archive_command

Destinos comunes de envío

archive_mode vs streaming

• La replicación por streaming envía WAL a los standbys en vivo.
• El archivado copia los segmentos completados a un almacenamiento duradero para PITR.
• Usa ambos: replicación para alta disponibilidad (HA), archivo para retroceder y cumplimiento normativo.

Errores comunes

• NFS lleno o montaje obsoleto - failed_count aumenta; la cadena PITR se rompe. Solución: Monitorizar el disco y pg_stat_archiver.
• archive_command no idempotente - El reintento falla si la sobrescritura no está permitida. Solución: Guardia test ! -f o pgBackRest.
• archive_mode solo en standby - El standby no genera nuevo WAL para archivar para PITR de escrituras primarias. Solución: Archivar en el primario (o pgBackRest desde la política de copias de seguridad del standby).
• Archivo lento bloquea el reciclaje de WAL - Presión de disco en el primario. Solución: Puesta en escena local rápida y luego carga asíncrona a S3.
• Olvidar reiniciar después de habilitar archive_mode - Parece configurado pero inactivo. Solución: Reiniciar PostgreSQL; confirmar SHOW archive_mode;.

Alternativas

Preguntas frecuentes

Relacionado

• Conceptos básicos de PITR - flujo de recuperación
• Opciones de destino de recuperación - detener la reproducción
• pgBackRest - archive-push
• Mejores prácticas de copia de seguridad - verificar archivos

Versiones de la pila: Esta página se escribió para PostgreSQL 18.4 (estable 18, mantenimiento 17), pgvector 0.8+, PgBouncer 1.x, Patroni 3.x y PostGIS 3.5+.