Page Comparison

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.

...

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 Quino Standard Version 10.23.0116.1 enthalten.

...

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.

...

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 Umwandlung notwendig macht. Zudem werden diese Ableitungen dazu verwendet die Verbindung mit der korrekte Datenbank aufzubauen und die datenbankabhängigen Datenbankabhängigen Abhängigkeiten zu injeziereninjizieren.

...

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 interne 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.

...