En este tema, aprenderemos cómo gestionar las migraciones de base de datos en una aplicación Flask utilizando Flask-Migrate. Las migraciones de base de datos son esenciales para mantener la estructura de la base de datos sincronizada con el código de la aplicación a medida que evoluciona.

Flask-Migrate es una extensión que utiliza Alembic para gestionar las migraciones de base de datos en aplicaciones Flask que usan SQLAlchemy. Permite crear, aplicar y revertir cambios en la estructura de la base de datos de manera controlada y reproducible.

Para comenzar, necesitamos instalar Flask-Migrate. Puedes hacerlo utilizando pip:

Una vez instalado, debemos configurar Flask-Migrate en nuestra aplicación Flask. A continuación, se muestra un ejemplo de cómo hacerlo:

En este ejemplo:

• Configuramos la URI de la base de datos.
• Inicializamos SQLAlchemy y Flask-Migrate.
• Definimos un modelo de ejemplo llamado User.

Para crear una migración, utilizamos el comando flask db migrate. Este comando genera un script de migración basado en los cambios detectados en los modelos de SQLAlchemy.

El parámetro -m permite agregar un mensaje descriptivo a la migración.

Una vez creada la migración, debemos aplicarla a la base de datos utilizando el comando flask db upgrade:

Este comando aplica todos los cambios pendientes a la base de datos.

Si necesitamos revertir una migración, podemos utilizar el comando flask db downgrade:

Este comando revierte la última migración aplicada. Podemos especificar un número de versión para revertir a una migración específica.

Supongamos que queremos agregar un nuevo campo age al modelo User. Primero, actualizamos el modelo:

Luego, creamos una nueva migración y la aplicamos:

1. Agrega un nuevo campo bio (tipo String) al modelo User.
2. Crea una migración para este cambio.
3. Aplica la migración a la base de datos.

1. Actualiza el modelo User:

   class User(db.Model):
       id = db.Column(db.Integer, primary_key=True)
       username = db.Column(db.String(80), unique=True, nullable=False)
       email = db.Column(db.String(120), unique=True, nullable=False)
       age = db.Column(db.Integer)
       bio = db.Column(db.String(200))  # Nuevo campo
   

2. Crea la migración:

   flask db migrate -m "Add bio field to User model."
   

3. Aplica la migración:

   flask db upgrade
   

En esta sección, hemos aprendido cómo utilizar Flask-Migrate para gestionar las migraciones de base de datos en una aplicación Flask. Hemos cubierto la instalación, configuración, creación, aplicación y reversión de migraciones, así como un ejemplo práctico y un ejercicio para reforzar los conceptos aprendidos. Con estas herramientas, puedes mantener la estructura de tu base de datos sincronizada con los cambios en tu código de manera eficiente y controlada.