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
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
| Schritte | Befehl | Funktion | Django-Äquivalent |
|---|---|---|---|
| Initialisieren | flask db init | Erstellen Sie ein Verzeichnis migrations/ (nur einmal ausführen). | — |
| Generieren | flask db migrate -m "description" | Modelländerungen erkennen und Migrationsskripte generieren. | makemigrations |
| Execute | flask db upgrade | Die 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
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
| Aktion | Flask(Flask-Migrate) | Django |
|---|---|---|
| Initialisieren | flask db init | Nicht erforderlich (das Projekt enthält bereits ein migrations-Verzeichnis). |
| Migration generieren | flask db migrate -m "description" | python manage.py makemigrations |
| Migration ausführen | flask db upgrade | python manage.py migrate |
| Rollback | flask db downgrade | python manage.py migrate app 0001 |
| Verlauf anzeigen | flask db history | python manage.py showmigrations |
| Grad der Automatisierung | Initialisierung 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