¿Cómo funcionan las migraciones?

Question

Accepted Answer

**Migraciones** son la forma que tiene Django de propagar los cambios que haces en tus modelos (añadir un campo, crear un modelo) al **esquema de la base de datos** — son archivos de cambio de base de datos controlados por versión y generados automáticamente. Cambias modelos en Python; las migraciones mantienen la base de datos sincronizada. ## El flujo de trabajo de dos pasos ```bash # 1. you change a model in models.py (e.g. add a field)... # 2. generate a migration file describing the change python manage.py makemigrations # → creates migrations/0002_article_views.py (the change, as Python) # 3. apply the migration to the database python manage.py migrate # → runs the SQL to alter the database schema (ADD COLUMN, etc.) ``` `makemigrations` detecta cambios en el modelo y genera un archivo de migración; `migrate` aplica las migraciones pendientes a la base de datos real. Escribes Python (cambios de modelos), y Django genera y ejecuta el SQL. ## Un archivo de migración es código controlado por versión ```python # migrations/0002_article_views.py (auto-generated) class Migration(migrations.Migration): dependencies = [("blog", "0001_initial")] # ordering — depends on the previous one operations = [ migrations.AddField( # the change model_name="article", name="views", field=models.IntegerField(default=0), ), ] ``` Las migraciones se **confirman en el control de versión**, por lo que el historial del esquema de la base de datos se rastrea junto con el código. Cada desarrollador y entorno aplica las mismas migraciones para alcanzar el mismo esquema — reproducible y consistente. ## Por qué es importante ```text ✓ Schema changes are version-controlled (tracked with the code, reviewable in PRs) ✓ Reproducible — every dev/staging/production DB gets the same schema by running migrate ✓ No manual, error-prone SQL — Django generates the correct ALTER statements ✓ Reversible — many migrations can be rolled back (migrate ) ✓ Team-friendly — schema changes flow through the normal code-review process ``` ## Comandos y conceptos útiles ```bash python manage.py showmigrations # see which migrations are applied/pending python manage.py sqlmigrate blog 0002 # preview the SQL a migration will run python manage.py makemigrations --empty # a blank migration for custom/data changes python manage.py migrate blog 0001 # roll BACK to a previous migration ``` ## Migraciones de datos (no solo esquema) ```text Migrations can also transform DATA (e.g. populate a new field, backfill values) via RunPython operations — useful when a schema change needs accompanying data changes. ``` ## Por qué importa Las migraciones son esenciales para trabajar con la capa de base de datos de Django — resuelven el problema crítico de mantener el esquema de la base de datos sincronizado con tus modelos Python de forma segura, reproducible y amigable con el equipo. Comprenderlas es conocimiento fundamental del día a día: el flujo de trabajo `makemigrations` → `migrate` es cómo sucede cada cambio de esquema (cambias modelos, Django genera y aplica el SQL), por lo que no puedes desarrollar una aplicación Django basada en datos sin él. El valor clave es que las migraciones hacen que los cambios de esquema sean **controlados por versión** (rastreados junto con el código, revisables en pull requests), **reproducibles** (cada entorno — la máquina de cada desarrollador, staging, producción — alcanza el esquema idéntico ejecutando las mismas migraciones), y **seguros** (Django genera SQL correcto, a menudo reversible, en lugar de declaraciones `ALTER TABLE` manuales propensas a errores). Esto elimina una categoría completa de problemas relacionados con la desviación del esquema, entornos inconsistentes y cambios manuales de base de datos arriesgados. Conocer el flujo de trabajo, que las migraciones se confirman en el control de código fuente, cómo inspeccionarlas y revertirlas, y que también pueden manejar **transformaciones de datos** (llenar datos anteriores/migrar datos, no solo esquema) es necesario para cualquier proyecto Django real. Las migraciones son cómo los equipos de Django evolucionan su esquema de base de datos de forma colaborativa y confiable durante la vida útil de un proyecto, haciendo que este sea material central y fundamental.