Migración de Base de Datos: Cambios de Schema y Deploy sin Downtime

¿Qué es la migración de base de datos?

La migración de base de datos es un proceso controlado utilizado para cambiar el schema de la base de datos (estructuras de tablas، índices، restricciones).

Cambios de schema: agregar nueva tabla، agregar/modificar/eliminar columna، agregar índice، agregar foreign key، cambiar tipo de dato.

Riesgos: pérdida de datos، downtime، degradación de rendimiento، incompatibilidad hacia atrás.

Objetivo: aplicar cambios de schema de forma segura، repetible y reversible.

Herramientas de migración

Flyway: herramienta de migración basada en SQL. archivos de migración versionados (V1__create_users.sql). soporte de Java، Node.js، CLI.

Liquibase: changelog en formato XML/YAML/JSON/SQL. soporte de rollback، generación de diff، comparación de bases de datos.

Prisma Migrate: integrado con Prisma ORM. genera automáticamente la migración desde schema.prisma.

Knex.js: herramienta de migración de Node.js. archivos de migración en JavaScript. funciones up y down.

Django/ActiveRecord: herramientas de migración integradas en el framework. crea automáticamente la migración a partir de cambios en el modelo.

Estrategias de migración sin downtime

Expand and Contract (Parallel Change): 1) agregar nueva columna/tabla (expand)، 2) actualizar código (soportar columna nueva y antigua)، 3) eliminar columna antigua (contract).

Cambios compatibles hacia atrás: agregar nueva columna (nullable)، agregar nueva tabla، agregar nuevo índice. estos cambios no requieren downtime.

Cambios breaking: eliminación de columna، cambio de tipo de columna، rename. estos cambios deben hacerse con el patrón expand-contract.

Feature flags: ponga el nuevo schema detrás de feature flag. reduzca el riesgo con rollout gradual.

Blue-green deployment: pruebe el nuevo schema en entorno paralelo. cambie el tráfico. vuelva al entorno anterior si hay problema.

Migración de datos

Backfill: haga que los datos existentes sean compatibles con el nuevo schema. procese grandes conjuntos de datos con procesamiento por lotes.

Dual write: escriba tanto en el schema antiguo como en el nuevo. mantenga la consistencia de datos durante el período de transición.

Validación de datos: verifique la integridad de los datos después de la migración. conteo de filas، checksum، comparación de muestra.

Rendimiento: la migración en tablas grandes crea carga de lock e I/O. ejecute durante horas de bajo tráfico. use procesamiento por chunks.

Plan de rollback

Down migration: escriba la down migration correspondiente (rollback) para cada up migration. Flyway، Liquibase soportan rollback.

Backup: tome un backup completo antes de la migración. tenga capacidad de point-in-time recovery (PITR).

Pruebas: pruebe la migración en el entorno de staging. use el mismo volumen de datos y schema que en producción.

Monitoreo: monitoree el rendimiento de las consultas y la tasa de error después de la migración. haga rollback si hay desviación anormal.

Comunicación: comparta el plan de migración con el equipo. defina la ventana de mantenimiento.

Mejores prácticas

Control de versiones: rastree los archivos de migración con Git. cada migración debe ser atómica (un solo cambio).

Idempotencia: ejecutar la migración varias veces debe producir el mismo resultado. use IF NOT EXISTS، IF EXISTS.

Migraciones pequeñas: divida los cambios grandes en migraciones pequeñas. cada migración debe ser desplegable independientemente.

Code review: pase los archivos de migración por code review. los cambios de schema son críticos y difíciles de revertir.

Documentación: documente el propósito y el impacto de cada migración. indique claramente los cambios breaking.