Page Comparison

WIP Die neue Schema Migration wurde von Grund auf neu geschrieben. Der Fokus lag dabei auf Verständlichkeit, Wartbarkeit, Sauberkeit, Erweiterbarkeit und natürlich Verlässlichkeit. Um diese Ziele zu erreichen wurde die Migration in möglichst wenige Einzelteile aufgeteilt, damit immer klar ist, welche Methode in welcher Klasse welche Auswirkungen hat.

Grundlagen

Für die Benutzer der Migration, die keine Änderungen am Standardverhalten vorgenommen haben, hat sich nichts verändert. Die neue Version ist ein Drop-In Replacement und ist in Releases ab Version 10.23.0116.1 enthalten.

Beim ersten Start einer Applikation mit der neuen Migration wird die bestehende Datenbank automatisch angepasst. Dabei werden alle von uns gemanagten DBMS-Objekte so umbenannt, dass sie den gleichen Namen, wie im Model tragen. Manuell erstelle Scripte, Trigger, Views, etc. müssen also an diese neuen Namen angepasst werden.

Aufbau

Die neue Migration ist grob in zwei Teile aufgeteilt.

Schema Creator

Der Schema Creator stellt nur eine Methode zur Verfügung.

DatabaseSchema CreateSchemaForModel(IMetaModel model, ILogger logger, string connectionString) wandelt das Bloqs-Modell in ein DatabaseSchema um, stellt sicher, dass das Modell valid ist und gibt die Möglichkeit feinere Anpassungen am Schema zu machen. Als Rückgabewert erhält man hier ein DatabaseSchema.

Um Datenbankspezifisches Verhalten zu erzielen gibt es zudem für jedes DBMS eine Ableitung; siehe PostgreSqlSchemaCreator.cs, SqlServerSchemaCreator.cs. Unterscheiden können sich z.B. Precision und Scale von Zahlenformaten, das Verhalten Triggern oder auch die Erstellung der Indexe.

Schema Migrator

Der Schema Migrator stellt mehrere Methoden zur Verfügung.

IList<Difference> CompareModelWithDatabase(IMetaModel model, ILogger logger) nimmt ein IMetaModel entgegen, vergleicht dieses mit der bestehenden Datenbank und gibt eine Liste an Differences zurück. Diese Methode kann zum Beispiel dazu verwendet werden, das bestehende Model mit den tatsächlichen Daten in der Datenbank zu vergleichen und macht es so sehr einfach die beiden abzugleiche; interessant unter anderem für DB-First Szenarien.

MigrationPlan GenerateMigrationPlan(IMetaModel model, ILogger logger) nimmt ein IMetaModel entgegen, vergleicht dieses mit der bestehenden Datenbank und generiert dann einen MigrationPlan. Dieser Plan enthält alle Informationen notwendig, um die bestehende Datenbank an das gegebene IMetaModel anzupassen.

bool TryMigrateDatabase(MigrationPlan migrationPlan, ILogger logger) nimmt den MigrationPlan entgegen und wendet diesen dann auf die konfigurierte Datenbank an. Dieser Prozess ist komplett von den restlichen Bloqs ADO-Funktionen losgelöst.

Um Datenbankspezifisches Verhalten zu erzielen gibt es zudem für jedes DBMS eine Ableitung; siehe PostgreSqlSchemaMigrator.cs, SqlServerSchemaMigrator.cs. Unterscheiden kann sich z.B. wie Daten in der Datenbank gespeichert werden, was unter Umständen eine Umwanldung notwendig macht. Zudem werden diese Ableitungen dazu verwendet die Verbindung mit der korrekte Datenbank aufzubauen und die datenbankabhängigen Abhängigkeiten zu injezieren.

Erweiterbarkeit

In manchen Fällen ist es gewünscht oder Notwendig die Migration anzupassen. Um dies zu ermöglichen wurde die komplette Migration möglichst offen gestaltet. Jede interene Methode ist als protected virtual markiert und kann einfach überschrieben werden. So ist es z.B. möglich einzelne Aspekte der Migration zu verändern, ohne den Rest anfassen zu müssen. Zudem sind Methoden, die neue Objekte generieren, immer auch einzeln überschreibbar, um möglichst modular zu sein.

Konfiguration

Durch die Applikationskonfiguration (standard IConfiguration) besteht die Möglichkeit die Migration zu konfigurieren. Um dies zu tun muss einfach nur ein neuer Key mit dem Namen SchemaMigration angelegt werden. Aktuell steht aber nur eine Option zur Verfügung.

RunInTransaction: Konfiguriert, ob die Migration in einer DB-Transaktion ausgeführt werden soll; default: true.