homenode.dev
Artículos

PostgreSQL 19: REPACK concurrente y qué revisar antes de actualizar

PostgreSQL 19 incorpora REPACK, mejoras de autovacuum y novedades en replicación. Repasamos sus límites y cómo preparar una migración de versión mayor.

El proyecto PostgreSQL publicó la versión estable 19.0 el 19 de noviembre de 2026. Entre sus novedades están REPACK, un comando para reescribir tablas y recuperar espacio; mejoras de autovacuum; y nuevas opciones de replicación lógica.

Para un homelab que almacena datos de aplicaciones, métricas o automatizaciones, el cambio más visible puede ser REPACK (CONCURRENTLY). Permite mantener lecturas y escrituras durante buena parte de la reorganización de una tabla. Hay matices importantes: la operación necesita espacio adicional, adquiere bloqueos y tiene restricciones de uso.

Las notas oficiales de PostgreSQL 19 reúnen todos los cambios e incompatibilidades. Aquí repasamos los que más afectan al mantenimiento diario.

REPACK y el espacio en disco

Las actualizaciones y eliminaciones dejan versiones antiguas de filas que PostgreSQL debe gestionar. El VACUUM habitual limpia esas versiones para que el espacio pueda reutilizarse. Una reescritura de la tabla puede compactarla y devolver espacio al sistema operativo.

PostgreSQL 19 incorpora REPACK para reescribir tablas y sus índices. Con USING INDEX también puede reorganizar físicamente las filas según un índice. Esa organización puede ayudar a determinadas consultas, aunque el beneficio depende de los datos y del patrón de acceso.

REPACK no sustituye el mantenimiento rutinario con VACUUM y autovacuum. La documentación advierte de que reescribir toda la tabla y sus índices no es una buena estrategia para prevenir el agotamiento de identificadores de transacción: puede tardar mucho y fallar después de haber realizado gran parte del trabajo.

Qué significa concurrente

La variante REPACK (CONCURRENTLY) permite que otras transacciones sigan leyendo y escribiendo durante la mayor parte de la operación. PostgreSQL copia la tabla, registra los cambios concurrentes y los aplica antes de intercambiar los archivos antiguos por los nuevos.

Eso no significa que funcione sin bloqueos. Según la documentación del comando:

  • Durante la mayor parte del proceso mantiene un bloqueo SHARE UPDATE EXCLUSIVE.
  • En la fase final necesita un bloqueo ACCESS EXCLUSIVE para intercambiar los archivos. Normalmente se mantiene poco tiempo, pero puede esperar a otras transacciones y su duración depende de los cambios acumulados.
  • Las operaciones DDL concurrentes sobre la tabla pueden hacer que el proceso no termine correctamente.
  • La opción concurrente no es segura para todas las instantáneas MVCC: una transacción que conserve una instantánea anterior al inicio del proceso puede ver la tabla vacía después de que finalice.

El modo sin CONCURRENTLY adquiere ACCESS EXCLUSIVE desde el principio y lo mantiene durante la operación. Por eso hay que elegir la variante y la ventana de mantenimiento según la carga real.

Requisitos y recursos

Antes de ejecutar REPACK, revisa el espacio libre. La documentación pide al menos espacio equivalente al tamaño de la tabla y sus índices para las copias temporales. La ordenación y los cambios concurrentes pueden necesitar almacenamiento adicional. También hay que considerar el uso de memoria y la actividad de disco.

La variante concurrente tiene requisitos concretos. Entre otros, no se puede ejecutar dentro de un bloque de transacción ni directamente sobre una tabla particionada, una tabla UNLOGGED o una vista materializada. La tabla necesita una clave primaria o una identidad de réplica basada en índice, y la configuración debe permitir crear el replication slot que necesita la operación.

Un ejemplo para una tabla concreta sería:

REPACK (CONCURRENTLY) public.eventos;

Es sintaxis documentada para PostgreSQL 19, no una recomendación para ejecutarla sin evaluar la tabla. Comprueba primero los requisitos, los bloqueos posibles, el espacio y el impacto en tu aplicación. El progreso se puede consultar en pg_stat_progress_repack.

Autovacuum con prioridades

PostgreSQL 19 incorpora procesamiento paralelo de índices para autovacuum y un sistema de puntuación que ayuda a decidir qué tablas atender primero. También añade pg_stat_autovacuum_scores para observar esa priorización, según el anuncio oficial.

Esto amplía las herramientas de administración, pero no elimina la necesidad de supervisar tablas con muchas escrituras. Revisa la frecuencia del mantenimiento, el crecimiento del almacenamiento y las transacciones largas antes de cambiar parámetros. El paralelismo disponible depende de la configuración del servidor y de cada tabla.

Replicación y lecturas

La nueva versión facilita activar la replicación lógica cuando wal_level está configurado como replica: al crear el primer slot lógico, PostgreSQL puede elevar el nivel efectivo de WAL sin reiniciar el servidor. Las notas de la versión también añaden replicación lógica de valores de secuencias.

Para aplicaciones que consultan réplicas, WAIT FOR LSN permite que una sesión en espera aguarde hasta que la réplica haya aplicado el WAL hasta una posición concreta. Puede servir para implementar lecturas que incluyan una escritura anterior, siempre que la aplicación gestione correctamente la posición y la espera. No convierte automáticamente todas las lecturas de una réplica en lecturas consistentes con la última escritura.

Estas opciones merecen pruebas específicas si dependes de replicación o planeas usarla para migrar. Revisa la documentación y las notas de migración antes de cambiar una configuración existente.

Antes de actualizar

PostgreSQL 19 es una versión mayor. El proyecto indica que para migrar desde versiones anteriores hay que utilizar una vía como pg_upgrade, volcado y restauración, o replicación lógica. Cambiar la imagen de un contenedor por otra con la etiqueta 19 no constituye por sí solo una migración de datos.

Una preparación razonable incluye:

  1. Inventariar versiones y extensiones. Comprueba que la aplicación, sus controladores, extensiones y herramientas de copia admiten PostgreSQL 19.
  2. Hacer una copia y probar la restauración. Una copia solo es útil para la recuperación si sabes restaurarla y dispones de los componentes necesarios.
  3. Leer las incompatibilidades. Por ejemplo, PostgreSQL 19 elimina el soporte de autenticación RADIUS y cambia algunos valores y comportamientos. Las notas oficiales detallan los casos afectados.
  4. Ensayar la migración con datos representativos. Comprueba tiempos, espacio libre, consultas y funciones de la aplicación en un entorno de prueba.
  5. Preparar la vuelta atrás. Define cómo recuperar el servicio y qué ocurrirá con las escrituras realizadas después del cambio.

REPACK puede facilitar una tarea de mantenimiento que antes exigía compromisos importantes de disponibilidad. Sigue siendo una operación costosa sobre datos reales: conviene usarla cuando se necesita compactar o reorganizar una tabla, después de revisar sus condiciones y probar el procedimiento.

Fuentes