Migraciones de base de datos en caliente: expandir, después contraer, con un límite claro para el rollback

EN BREVE: Al cambiar un esquema en producción, el peligro no suele estar en el SQL sino en el periodo en que conviven la versión antigua y la nueva del código. Trabajamos con expandir-contraer: añadir sin quitar para que ambas versiones funcionen, rellenar los datos históricos por lotes, cambiar las lecturas y borrar la estructura antigua solo cuando nadie la use. Cada paso es un despliegue propio. Hasta el borrado se puede hacer rollback en cualquier momento; después, solo corregir hacia delante.

Los cinco pasos de una migración expandir-contraer: expandir añadiendo una columna nueva, doble escritura en la antigua y la nueva, relleno por lotes reanudable, cambio de lecturas a la estructura nueva con observación, y contraer dejando de escribir en la columna antigua y borrándola. Antes de contraer hay un punto sin retorno: antes de él, rollback es revertir el último despliegue; después, solo se corrige hacia delante. Antes del paso 5 se buscan lectores de la columna antigua en todos los repositorios, informes y sincronizaciones.
Figura 1. Cinco despliegues y un punto sin retorno. El borrado va al final y se despliega solo.

1.0 Por qué no en un solo paso

Durante un despliegue progresivo, las instancias antiguas siguen atendiendo peticiones, y las apps móviles o los sistemas externos pueden seguir llamando a la interfaz antigua. Una migración que renombra una columna rompe al instante el código antiguo que aún no se ha retirado. Además, algunas DDL sobre tablas grandes mantienen bloqueos durante mucho tiempo y dejan en cola las peticiones normales.

2.0 Los cinco pasos

PasoQué ocurre¿Reversible?
1 ExpandirAñadir la columna o tabla nueva, nullable o con valor por defecto; la estructura antigua no se tocaSí, se borra la columna nueva
2 Doble escrituraEl código nuevo escribe en la antigua y en la nueva; las lecturas siguen en la antiguaSí, se revierte el código
3 RellenoCopiar los datos históricos a la estructura nueva por lotes, reentrante y con pausa posibleSí
4 Cambiar lecturasLas lecturas pasan a la estructura nueva y se observan un tiempo; la antigua se sigue escribiendoSí, se vuelve atrás
5 ContraerDejar de escribir la estructura antigua y después borrarlaNo, tras el borrado

Antes del paso 5 conviene parar y confirmar que ningún código, informe o sincronización externa lee aún la columna antigua. Lo comprobamos con una búsqueda en todos los repositorios y con los logs de acceso a la base de datos, no de memoria.

3.0 El relleno

  • Trabajar por rangos de clave primaria, una transacción corta por lote y una pausa entre lotes, para evitar transacciones largas y retraso de réplica.
  • Hacer el relleno reentrante: tras una interrupción continúa donde se quedó, y ejecutarlo dos veces da el mismo resultado.
  • Registrar el progreso y las filas que fallan, y tratarlas aparte para que una fila defectuosa no bloquee todo el relleno.
  • Las escrituras nuevas durante el relleno ya las cubre la doble escritura, así que el relleno solo se ocupa del histórico.

4.0 Operaciones que bloquean tablas

Las bases de datos y sus versiones difieren mucho, así que lea la documentación oficial antes de empezar. Algunos casos frecuentes:

  • En PostgreSQL, cree los índices con CREATE INDEX CONCURRENTLY para no bloquear escrituras. No puede ejecutarse dentro de un bloque de transacción, y si falla deja un índice inválido que hay que borrar y recrear.
  • Para añadir una columna NOT NULL a una tabla con datos, añádala primero como nullable, rellénela y después añada la restricción.
  • En MySQL, compruebe para su versión qué operaciones admite la DDL en línea y con qué algoritmo; para tablas grandes, valore una herramienta como gh-ost.
  • Fije un tiempo máximo de espera de bloqueo en la sesión de migración. Si no consigue el bloqueo debe fallar y reintentar más tarde, no esperar en la cola de bloqueos frenando todas las peticiones de detrás.

5.0 Migraciones en CI y en el proceso de despliegue

  • Los archivos de migración se numeran en orden y se guardan en el repositorio. Una migración ya desplegada nunca se edita; los errores se corrigen con una migración nueva.
  • La CI ejecuta dos caminos: todas las migraciones sobre una base vacía, y las migraciones nuevas sobre una base en el estado del despliegue anterior. Ambos deben dar el mismo esquema.
  • Antes del despliegue, ejecute la migración sobre una copia anonimizada de los datos de producción y anote cuánto tarda, para decidir si debe ir en horario de poca carga.
  • Antes de cada migración existe una copia de seguridad utilizable cuya restauración se ha ensayado. Una copia que nunca se ha restaurado no cuenta.

Si un sistema existente necesita un cambio de esquema importante, o las migraciones dan problemas una y otra vez, consulte Web, nube y gestión de dispositivos o hable de un proyecto con nosotros.

Referencias

Preguntas frecuentes

¿Un proyecto pequeño necesita de verdad todos estos pasos?

Si una ventana de mantenimiento corta es aceptable y ningún cliente depende todavía de la interfaz antigua, parar el servicio y cambiar la tabla es más sencillo y perfectamente válido. Expandir-contraer es para sistemas que no pueden parar o donde el código antiguo y el nuevo van a convivir sí o sí.

¿La doble escritura puede dejar datos inconsistentes?

Ese riesgo existe. Antes de cambiar las lecturas se comparan por muestreo los datos antiguos y los nuevos, y tras el relleno se vuelven a comparar por completo los campos clave. Si las dos escrituras caben en la misma transacción, van en la misma.

¿Podemos usar tal cual las migraciones que genera el ORM?

Sirven como primer borrador, pero alguien debe leer el SQL generado antes del despliegue, sobre todo en renombrados, cambios de tipo y borrados. Las herramientas suelen convertir un renombrado en borrar la columna y crearla de nuevo, y los datos desaparecen.

¿Qué pasa si una migración falla a mitad?

Antes del paso 5, se revierte el último despliegue y se vuelve al punto de partida. Una estructura ya borrada solo se recupera desde una copia de seguridad o corrigiendo hacia delante; por eso el borrado va al final, en un despliegue propio y tras un tiempo de observación suficiente.