Een migratie initialiseren en automatisch genereren

Voeg eerst het pakket aan je project toe. Flask-Migrate levert Alembic en een reeks handige flask db-opdrachten. 📦

Maak een object van Migrate en koppel het aan je app en database. Met die ene regel activeer je de volledige opdrachtgroep flask db.

Voer flask db init één keer per project uit. Hiermee wordt een map voor migraties aangemaakt waarin elk versiescript dat je genereert wordt opgeslagen.

De nieuwe map bevat een alembic.ini, een env.py en een lege map versions waarin toekomstige migratiebestanden komen te staan.

flask db migrate vergelijkt je modellen met het actieve schema en schrijft een script waarin precies staat wat er is veranderd.

Geef altijd een duidelijk bericht mee met -m. Hiermee label je de migratie, zodat je team de geschiedenis later als een wijzigingslog kan lezen.

Elke migrate-opdracht maakt een nieuw bestand aan in versions, met een willekeurige revisie-id en een verkorte versie van je bericht als naam.

Autogenerate ziet alleen modellen die daadwerkelijk zijn geïmporteerd wanneer de opdracht wordt uitgevoerd. Ontbrekende imports betekenen ontbrekende tabellen in het script.

Alembic vergelijkt de metagegevens van je modellen met de database. Nieuwe tabellen, toegevoegde kolommen en veel gewijzigde beperkingen worden automatisch gedetecteerd.

Belangrijk: migrate schrijft alleen het script. Je database blijft onaangeroerd totdat je het script in de volgende les daadwerkelijk toepast.

Behandel migratiebestanden als code en commit ze naar git. Teamleden kunnen exact dezelfde wijzigingen opnieuw uitvoeren vanuit je versiegeschiedenis.

Je hebt Migrate gekoppeld, flask db init uitgevoerd en met flask db migrate automatisch een script gegenereerd dat klaar is om toe te passen. 🎉