- \n
- Code-basierte Migration: Muss durch den Entwickler ausgelöst werden.<\/li>\n
- Automatische Migration: Erfolgt automatisch, hat aber Einschränkungen.<\/li>\n<\/ul>\n
In den folgenden Abschnitten schauen wir uns die verschiedenen Funktionen an.<\/p>\n
Code-basierte Migration<\/h2>\n
Die code-basierte Migration erfordert den Aufruf verschiedener Befehle über die Paket-Manager-Konsole. Diese starten Sie über den Menübefehl Extras|NuGet-Paket-Manager|Paket-Manager-Konsole<\/b>. Hier können Sie die folgenden Anweisungen eingeben:<\/p>\n
- \n
- Enable-Migrations<\/b>: Aktiviert die Migration für das aktuelle Projekt und erstellt einen neuen Ordner namens Migrations <\/b>mit einer neuen Klasse namens Configuration<\/b>.<\/li>\n
- Add-Migration<\/b>: Erfasst die Unterschiede zwischen dem Entity Data Model im Vergleich zur Datenbank und trägt diese in jeweils eine neue Klasse in zwei Methoden namens Up <\/b>und Down <\/b>ein. Die Methoden enthalten die Anweisungen zum Erstellen, Löschen oder Ändern der Datenbankobjekte entsprechend den Änderungen im Entity Data Model.<\/li>\n
- Update-Database<\/b>: Diese Methode überträgt alle noch nicht übertragenen Änderungen aus den mit Add-Migration <\/b>erstellten Klassen in die Tabellen der Datenbank.<\/li>\n<\/ul>\n
Um die Migrations-Funktionen zu nutzen, müssen sie diese mit der ersten Anweisung Enable-Migrations <\/b>aktivieren. Diese Anweisung setzen Sie in der Paket-Manager-Konsole ab (siehe Bild 1):<\/p>\n
![\"Aktivieren](\"..\/fileadmin\/_temp_\/2018_05\/pic_147_001.png\")
<\/p>\nBild 1: Aktivieren der Datenbank-Migrationen<\/span><\/b><\/p>\n
Enable-Migrations<\/pre>\n
Dies quittiert die Paket-Manager-Konsole damit, dass Code First-Migrationen für das Projekt aktiviert sind. Was hat sich dadurch verändert Im Projektmappen-Explorer finden wir nun einen neuen Ordner namens Migrations <\/b>mit der Klasse Configurations.vb<\/b> (siehe Bild 2).<\/p>\n
![\"Neuer](\"..\/fileadmin\/_temp_\/2018_05\/pic_147_002.png\")
<\/p>\nBild 2: Neuer Ordner Migrations<\/span><\/b><\/p>\n
Die Klasse stellt zwei Methoden bereit – die Konstruktor-Methode New <\/b>sowie eine Methode namens Seed<\/b>:<\/p>\n
Imports System.Data.Entity.Migrations\r\nNamespace Migrations\r\n Friend NotInheritable Class Configuration \r\n Inherits DbMigrationsConfiguration(Of ArticleContext)\r\n Public <\/span>Sub New()\r\n AutomaticMigrationsEnabled = False<\/span>\r\n End Sub\r\n Protected Overrides Sub Seed(context As <\/span>ArticleContext)\r\n '' This method will be called after migrating to the latest version.\r\n '' You can use the DbSet(Of T).AddOrUpdate() helper extension method \r\n '' to avoid creating duplicate seed data.\r\n End Sub\r\n End Class\r\nEnd Namespace<\/pre>\nDie Konstruktor-Methode stellt den Wert der Variablen AutomaticMigrationsEnabled <\/b>auf den Wert False <\/b>ein. Was bedeutet das Sie setzen AutomaticMigrationsEnabled <\/b>auf True<\/b>, wenn Sie keine Versionierung in dem Sinne planen, dass Sie nur Upgrades verwenden und keine Downgrades und keine strikte Versionierung planen. Das schauen wir uns weiter unten unter Automatische Migration aktivieren <\/b>an. Wenn Sie die Variable auf dem Wert False <\/b>belassen, müssen Sie die Migrationsschritte selbst definieren. Das schauen wir uns gleich im Anschluss an.<\/p>\n
Änderungen in Klasse notieren<\/h2>\n
Danach können Sie erstmals die Anweisung Add-Migration <\/b>aufrufen und dieser einen Parameter mitgeben, der später als Teil des Namens der durch diese Anweisung erstellten Klasse verwendet wird (der Rest besteht aus Datum und Zeit). Die erste Migration soll beispielsweise den Text Init <\/b>im Namen der zu erstellenden Klasse tragen. Die folgende Anweisung setzen Sie ebenfalls in der Paket-Manager-Konsole ab. Die Ausführung kann einige Sekunden dauern:<\/p>\n
Add-Migration Init<\/pre>\n
Die so erstellte Klasse heißt 201811070831578_init.vb <\/b>und taucht im Ordner Migrations <\/b>des Projektmappen-Explorers auf (siehe Bild 3). Sie sieht mit den beiden Methoden Up <\/b>und Down <\/b>in gekürzter Form wie folgt aus:<\/p>\n
![\"Neue](\"..\/fileadmin\/_temp_\/2018_05\/pic_147_003.png\")
<\/p>\nBild 3: Neue Klasse, die auf init.vb endet<\/span><\/b><\/p>\n
Imports System.Data.Entity.Migrations\r\nNamespace Migrations\r\n Public <\/span>Partial Class init\r\n Inherits DbMigration\r\n Public <\/span>Overrides Sub Up()\r\n CreateTable(\"dbo.Articles\",\r\n Function(c) New<\/span> With<\/span>\r\n {\r\n .ID = c.Int(nullable := False, identity := True<\/span>),\r\n .Name = c.String(),\r\n .CategoryID = c.Int(nullable := False<\/span>),\r\n .Price = c.Decimal(nullable := False, precision := 18, scale := 2),\r\n .Description = c.String()\r\n }) _\r\n .PrimaryKey(Function(t) t.ID) _\r\n .ForeignKey(\"dbo.Categories\", Function(t) t.CategoryID, cascadeDelete := True<\/span>) _\r\n .Index(Function(t) t.CategoryID)\r\n CreateTable(\r\n \"dbo.Categories\",\r\n Function(c) New<\/span> With<\/span>\r\n {\r\n .ID = c.Int(nullable := False, identity := True<\/span>),\r\n .Name = c.String()\r\n }) _\r\n .PrimaryKey(Function(t) t.ID)\r\n End Sub\r\n \r\n Public <\/span>Overrides Sub Down()\r\n DropForeignKey(\"dbo.Articles\", \"CategoryID\", \"dbo.Categories\")\r\n DropIndex(\"dbo.Articles\", New<\/span> String() { \"CategoryID\" })\r\n DropTable(\"dbo.Categories\")\r\n DropTable(\"dbo.Articles\")\r\n End Sub\r\n End Class\r\nEnd Namespace<\/pre>\nDie meisten der Methoden, die hier zum Einsatz kommen, stammen aus dem Namespace System.Data.Entity.Migrations<\/b>. Die Methode Up <\/b>enthält zwei CreateTable<\/b>-Anweisungen, mit denen die Tabellen Articles <\/b>und Categories <\/b>erstellt werden sollen. Wir haben also hier eine Möglichkeit, Tabellen und ihre Felder sowie die Restriktionen objektorientiert anzulegen statt mit T-SQL-Anweisungen. Letztendlich werden die Befehle natürlich auch wieder in T-SQL übersetzt, aber für manchen Entwickler, der sich vielleicht nicht mit T-SQL anfreunden möchte, bietet sich hier eine Alternative. Die Methode Down <\/b>enthält vier Anweisungen, mit denen nacheinander die Restriktionen und die Tabellen gelöscht werden.<\/p>\n
Änderungen in die Datenbank übertragen<\/h2>\n
Möchten Sie weiterlesen? Dann lösen Sie Ihr Ticket!<\/span>
\nHier geht es zur Bestellung des Jahresabonnements des Magazins Visual Basic Entwickler<\/strong>:<\/span>
\nZur Bestellung ...<\/a><\/span>
\nDanach greifen Sie sofort auf alle rund 200 Artikel<\/strong> unseres Angebots zu - auch auf diesen hier!<\/span>
\nOder haben Sie bereits Zugangsdaten? Dann loggen Sie sich gleich hier ein:<\/span><\/p>\n<\/div>\n\n\t\n\t - Add-Migration<\/b>: Erfasst die Unterschiede zwischen dem Entity Data Model im Vergleich zur Datenbank und trägt diese in jeweils eine neue Klasse in zwei Methoden namens Up <\/b>und Down <\/b>ein. Die Methoden enthalten die Anweisungen zum Erstellen, Löschen oder Ändern der Datenbankobjekte entsprechend den Änderungen im Entity Data Model.<\/li>\n
- Enable-Migrations<\/b>: Aktiviert die Migration für das aktuelle Projekt und erstellt einen neuen Ordner namens Migrations <\/b>mit einer neuen Klasse namens Configuration<\/b>.<\/li>\n