Datenbank und Migrationen
Schemaänderungen kontrolliert, versioniert und nachvollziehbar installieren.
Warum Migrationen?
Tabellen und Spalten sollen bei einem normalen Seitenaufruf nicht unbemerkt erzeugt oder repariert werden. Jede neue Kernstruktur erhält deshalb eine feste Version, Beschreibung und Prüfsumme.
Übersicht lesen
Aktuelle DB-Version zeigt die höchste erfolgreich angewandte Version. Ausstehend wartet auf Ausführung, Fehlgeschlagen enthält den letzten Fehler, und Verändert weist auf eine geänderte Datei nach bereits erfolgter Installation hin.
Sicher ausführen
Vor Änderungen gehört ein Datenbank-Backup dazu. „Nächste Migration“ führt genau den nächsten Schritt aus; „Alle offenen“ verarbeitet die Reihenfolge. Ein Fehler stoppt an der betroffenen Version und bleibt mit Laufzeit und Meldung sichtbar.
Kompatibilität vorhandener Installationen
Eine Migration prüft vorhandene Tabellen und Spalten, bevor sie ergänzt. Bereits bestehende Strukturen werden übernommen, nicht blind doppelt angelegt.
Die Spalte last_processed_season_id existiert bereits. Die Migration erkennt sie, markiert den Schritt erfolgreich und löst keinen „Duplicate column“-Fehler aus.
Strikter Migrationsbetrieb
Migration 202607280017 übernimmt die verbliebenen älteren Schema-Installer genau einmal. Danach blockieren normale Seiten, Aktionen, Jobs, Cronjobs und Simulationen jede dort noch vorhandene CREATE- oder ALTER-Anweisung. Die alten Definitionen bleiben vorläufig nur als Quelle für bestehende Installationen erhalten; ausgeführt werden sie ausschließlich im Migrationskontext.
Fehlende Struktur richtig behandeln
Fehlt nach der Abschlussmigration eine Tabelle oder Spalte, soll die Fachfunktion eine verständliche Meldung liefern und auf offene Migrationen hinweisen. Sie repariert die Datenbank nicht heimlich selbst. Nur die Migrationsseite und das ausdrücklich gestartete System-Reparaturwerkzeug dürfen Schemaänderungen ausführen.
- Datenbank sichern.
- Alle offenen Migrationen in Reihenfolge ausführen.
- Migration 202607280017 muss erfolgreich sein.
- Systemdiagnose und Smoke-Tests starten.
- Erst danach normale Jobs und Simulation wieder prüfen.
Eine Verwaltungsfunktion benötigt verein.no_u19_expected. Fehlt die Spalte, stoppt sie mit dem Hinweis auf offene Migrationen, statt beim Seitenaufruf ALTER TABLE auszuführen.
Häufige Fragen
Warum verändert ein Seitenaufruf die Datenbank nicht mehr?
Nach Migration 202607280017 werden die alten Schema-Helfer außerhalb einer kontrollierten Migration zentral gesperrt.
Darf „Fehlende DB-Strukturen reparieren“ weiterhin etwas anlegen?
Ja, aber nur nach bewusster Adminaktion. Es ist ein Notfallwerkzeug und kein Bestandteil eines normalen Seiten-, Job- oder Simulationslaufs.