Revise y edite scripts generados

La generación automática es un excelente primer borrador, no una respuesta definitiva. Revise siempre el script antes de aplicarlo en cualquier entorno. 🔍

Cada script se encuentra en la carpeta versions. Ábralo y lea las funciones upgrade y downgrade como cualquier otro código.

Dentro de las funciones verá llamadas al objeto op, como op.create_table y op.add_column; cada una describe un cambio del esquema.

La generación automática suele pasar por alto los renombrados y los interpreta como una eliminación seguida de una adición. Eso borraría silenciosamente los datos de la columna.

Cuando una columna realmente cambia de nombre, sustituya la eliminación y la adición por un único alter_column que conserve los datos.

Confirme que downgrade revierte realmente upgrade. Un downgrade defectuoso le dejará bloqueado si alguna vez necesita volver atrás.

Añadir una columna que no admite valores nulos a una tabla con filas provocará un error. Añádala primero como nullable, rellene los valores y después conviértala en required.

¿Necesita completar valores existentes? Añada una llamada op.execute con SQL sin procesar entre los pasos del esquema para migrar los datos existentes de forma segura.

Antes de tocar producción, ejecute la migración sobre una copia de los datos reales. Así detectará los fallos cuando aún sea barato corregirlos.

Mantenga cada migración centrada en un único cambio lógico. Los scripts pequeños son mucho más fáciles de revisar, probar y revertir correctamente.

Después de editarlo y probarlo, haga commit del script. No cambie nunca una migración que ya se haya publicado en el historial de producción.

Aprendió a revisar scripts generados, corregir renombrados con alter_column, gestionar columnas que no admiten valores nulos y probar antes de publicar. 🎉