Flask-Migrate — Datenbankmigrationen

In diesem Kapitel lernen Sie, wie Sie Datenbankschema-Änderungen mit Flask-Migrate sicher verwalten und wie dies den Django-Migrationen entspricht.


Warum können wir nicht immer db.create_all() verwenden?

db.create_all()Es gibt zwei gravierende Fehler:

  • Erstellt nur, wenn die Tabelle nicht existiert. Das Ändern des Modells (z. B. das Hinzufügen neuer Felder) aktualisiert vorhandene Tabellen nicht.
  • Es wird kein Änderungsverlauf geführt. Ein Rollback auf einen früheren Datenbankzustand ist nicht möglich.

DatenbankmigrationenGenau wie Git für Datenbanken – jede Schemaänderung erzeugt eine Versionsdatei, die Upgrades und Rollbacks unterstützt.

Flask-MigrateEs ist eine Flask-Erweiterung für Alembic, speziell für SQLAlchemy entwickelt.


Installation und Konfiguration

(venv) $ pip install flask-migrate

Beispiel

# Dateipfad: app.py
from flask import Flask
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate

app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///blog.db'

db = SQLAlchemy(app)
migrate = Migrate(app, db)    # app und db an Migrate binden

Migration in drei Schritten

SchritteBefehlFunktionDjango-Äquivalent
Initialisierenflask db initErstellen Sie ein Verzeichnis migrations/ (nur einmal ausführen).—
Generierenflask db migrate -m "description"Modelländerungen erkennen und Migrationsskripte generieren.makemigrations
Executeflask db upgradeDie Migrationsskripte auf die Datenbank anwenden.migrate

Schritt 1: Das Migrationsverzeichnis initialisieren

(venv) $ flask db init
Creating directory migrations/...  done

Nach der Ausführung generiertmigrations/Verzeichnis (ähnlich wie Gits .git-Verzeichnis), muss nur einmal ausgeführt werden.

Schritt 2: Migrationsdateien generieren.

(venv) $ flask db migrate -m "初始化 Post 和 Category 模型"
INFO  [alembic.runtime.migration] Context impl SQLiteImpl.
Generating migrations/versions/xxxx_initial.py ... done

Wenn Sie noch keine Modelländerungen haben, führen Sie einfach diesen Befehl für ein vorhandenes Modell aus.

Schritt 3: Migrationen ausführen.

(venv) $ flask db upgrade
INFO  [alembic.runtime.migration] Running upgrade  -> xxxx, 初始化

Praxis: Fügen Sie dem Post-Modell ein neues Feld hinzu.

Angenommen, die Produktanforderungen ändern sich und Sie müssen dem Artikel eine Leseanzahl hinzufügen.

Beispiel

# Dateipfad: hinzugefügt in der Post-Klasse von models.py
class Post(db.Model):
    # ... vorhandene Felder ...
    read_count = db.Column(db.Integer, default=0)  # Neu: Leseanzahl

Nach dem Ändern des Modells Migrationen ausführen:

(venv) $ flask db migrate -m "Post 模型新增 read_count 字段"
(venv) $ flask db upgrade

Jetzt in der DatenbankpostsDie Tabelle wurde automatisch hinzugefügtread_countSpalten, vorhandene Daten sind nicht betroffen.

Migrationsverlauf anzeigen

Überprüfen Sie, welche Version die aktuelle Datenbank hat:

(venv) $ flask db current

Alle Migrationsverläufe anzeigen:

(venv) $ flask db history

Migration zurückrollen

Migrationen können zurückgerollt werden:

(venv) $ flask db downgrade   # 回退到上一个版本

Dies löschtread_countSpalte, alle Änderungen aus der letzten Migration rückgängig machen.

Nicht alle Vorgänge können automatisch zurückgerollt werden (z. B. das Löschen einer Spalte in SQLite). Bestätigen Sie den Vorgang vor dem Zurückrollen.flask db currentPrüfen Sie die aktuelle Version, um sicherzustellen, dass Sie wissen, was Sie zurückrollen. Erstellen Sie vor einem Rollback in der Produktion immer eine Datensicherung.


Flask-Migrate vs. Django: Migrationsvergleich

AktionFlask(Flask-Migrate)Django
Initialisierenflask db initNicht erforderlich (das Projekt enthält bereits ein migrations-Verzeichnis).
Migration generierenflask db migrate -m "description"python manage.py makemigrations
Migration ausführenflask db upgradepython manage.py migrate
Rollbackflask db downgradepython manage.py migrate app 0001
Verlauf anzeigenflask db historypython manage.py showmigrations
Grad der AutomatisierungInitialisierung ist erforderlich; sie erkennt die Alembic-Abhängigkeit.Vollautomatisch, keine zusätzliche Konfiguration erforderlich.

Djangos Migrationssystem ist automatisierter und stärker integriert; Flask erreicht dieselbe Leistungsfähigkeit durch Flask-Migrate.


Kapitelzusammenfassung

In diesem Kapitel haben Sie den vollständigen Flask-Migrate-Workflow gemeistert: flask db init initialisiert, flask db migrate generiert Migrationsskripte, flask db upgrade wendet Migrationen an und flask db downgrade macht sie rückgängig.

Ab jetzt folgen Sie jedes Mal, wenn Sie models.py ändern, diesem dreistufigen Workflow, und Änderungen am Datenbankschema haben stets eine nachvollziehbare Historie.

Weitere Erweiterungen