Entscheidungsleitfaden für die Migration von Entity Framework 6 zu EF Core

Entity Framework 6 zu EF Core: Lohnt sich die Migration, und was geht dabei kaputt?

Entity Framework 6 ist für eine Legacy-Technologie in einer ungewöhnlichen Lage: Es gibt kein Support-Ende, das eine Entscheidung erzwingt. Die Bibliothek erhält weiterhin Fehlerbehebungen und läuft auf modernem .NET. Gleichzeitig sind alle neuen Funktionen der letzten Jahre in EF Core entstanden, einer anderen Bibliothek mit anderen Standardeinstellungen.

Die Frage lautet deshalb nicht nur, wie man migriert, sondern ob und wann. Dieser Leitfaden liefert die Kriterien für diese Entscheidung und zeigt anschließend, was in der Praxis bricht. Grundlage ist ein öffentliches Beispiel, das wir für unsere Leistungen zur Migration von Entity Framework 6 zu EF Core gebaut und getestet haben. Wenn Ihr Projekt zusätzlich die Datenbank-Engine wechselt oder in die Cloud umzieht, lesen Sie auch unseren Leitfaden zur Datenbankmigration ohne Ausfallzeiten, denn das ist eine eigene Aufgabe mit eigenen Risiken.

Wo Entity Framework 6 heute steht

Drei Fakten bestimmen die Entscheidung:

  • EF6 wird gepflegt, aber nicht weiterentwickelt. Es gibt Fehlerbehebungen, neue Funktionen erscheinen nur in EF Core.
  • EF6 läuft auf modernem .NET. Seit Version 6.3 funktioniert es auch außerhalb von .NET Framework. Sie können eine Anwendung auf eine aktuelle .NET-Laufzeit umstellen und die EF6-Datenschicht behalten.
  • EF Core ist nicht EF 7. Es wurde neu geschrieben. Die API sieht ähnlich aus, aber Konventionen, Ladeverhalten und mehrere Details beim Speichern von Werten unterscheiden sich.

Der zweite Punkt ist für die Planung der wichtigste. Wer .NET Framework verlässt, muss Entity Framework 6 nicht am selben Tag verlassen. Die beiden Migrationen können getrennte Projekte mit eigenen Tests und eigenen Budgets sein.

Gründe für die Migration und Gründe zu warten

Typische Gründe, die den Aufwand rechtfertigen:

  • Sie brauchen etwas, das es nur in EF Core gibt, etwa Massenänderungen und Massenlöschungen ohne Laden der Entitäten, das Mapping von JSON-Spalten oder kompilierte Modelle.
  • Sie wollen in alten und neuen Diensten dieselbe Technologie für den Datenzugriff, damit Entwickler nicht zwischen zwei Regelwerken wechseln.
  • Lazy Loading bereitet bereits Probleme: Seiten, die Dutzende versteckter Abfragen auslösen und sich schwer optimieren lassen.
  • Die Anwendung wird ohnehin modernisiert, und die dafür aufgebaute Testabdeckung kann auch die Datenschicht absichern.

Gründe, die Migration zu verschieben:

  • Das Modell ist eine EDMX-Datei mit vielen im Designer gemappten gespeicherten Prozeduren. EF Core kennt kein EDMX. Das ist eine Umstellung, kein Upgrade.
  • Es gibt keine automatisierten Tests rund um die Datenschicht, und niemand kann sagen, wie sie sich heute genau verhält.
  • Die Anwendung ist stabil, wird selten geändert und soll abgelöst werden.

Eine kurze Entscheidungstabelle

Ihre Situation Unsere Empfehlung
Die Anwendung bleibt auf .NET Framework und ändert sich selten EF6 behalten. Tests rund um die Datenschicht ergänzen, damit eine spätere Entscheidung günstig bleibt.
Die Anwendung zieht auf modernes .NET um, der Termin ist eng Zuerst die Laufzeit umstellen und EF6 behalten. EF Core als zweite Phase einplanen.
Code-First-Modell, brauchbare Testabdeckung, aktive Weiterentwicklung Auf der bestehenden Datenbank zu EF Core migrieren. Diesen Fall deckt unser Beispiel ab.
EDMX oder Database First mit gemappten gespeicherten Prozeduren Zuerst eine Analyse durchführen. Das Modell muss neu aus der Datenbank erzeugt werden, und der Aufwand hängt von den gespeicherten Prozeduren ab.
Neben der alten Anwendung entstehen neue Dienste EF Core für die neuen Dienste einsetzen und die alte Datenschicht Kontext für Kontext migrieren.

Was bricht: Erkenntnisse aus einem getesteten Beispiel

Die Meinungen zu dieser Migration reichen von „ein Wochenende“ bis „eine Neuentwicklung“. Um stattdessen Zahlen zu haben, haben wir ein kleines Beispiel veröffentlicht: die Datenschicht einer Auftragsverwaltung auf Entity Framework 6.5 Code First und dieselbe Datenschicht auf EF Core 10. Die SQL-Server-Datenbank ist für beide dieselbe, mit Tabellen und Zeilen genau so, wie EF6 sie angelegt hat. Eine Datei mit 17 Szenarien wird gegen beide Versionen kompiliert und läuft in der CI gegen einen echten SQL Server 2022. Beide Versionen bestehen 17 von 17. Der Code liegt in Fall 05 unseres GitHub-Repositorys, eine ausführlichere Beschreibung finden Sie auf legacy-modernisierung.de.

Interessant ist, was passierte, als wir einzelne Teile aus der fertigen EF-Core-Version entfernt und die Szenarien erneut ausgeführt haben.

Namen: 14 von 17 Szenarien schlagen fehl

Allein mit den Konventionen von EF Core, ohne ausdrückliches Mapping, schlagen 14 von 17 Szenarien fehl. EF6 hat eine Fremdschlüsselspalte Customer_Id genannt, EF Core sucht CustomerId. EF6 hat eine Verknüpfungstabelle TagOrders genannt, EF Core erwartet OrderTag. Das ist die laute Art von Fehler: Er zeigt sich bei der ersten Abfrage und wird behoben, indem man das Mapping ausschreibt.

Lazy Loading: 6 von 17 Szenarien schlagen fehl

Der EF6-Code liest einen Auftrag und greift danach auf den Namen des Kunden zu. Der Kunde wird beim ersten Zugriff geladen. In EF Core ist dieselbe Eigenschaft leer, solange die Abfrage sie nicht anfordert. Das Entfernen eines einzigen Include ließ 6 von 17 Szenarien fehlschlagen. EF Core bietet ein Paket, das Lazy Loading zurückbringt. Wer es einschaltet, um sich die Arbeit zu sparen, behält aber auch die versteckten Abfragen. Jede solche Stelle braucht ein Include oder eine Projektion, und sie alle zu finden ist der Teil der Migration, der am meisten Lesearbeit verlangt.

Dezimalwerte: ein Szenario, und es geht um Geld

Ein Wert mit drei Nachkommastellen wird in eine Spalte mit zwei Nachkommastellen geschrieben. EF6 speichert 19,999 als 19,99. EF Core speichert 20,00. Keine der beiden Bibliotheken meldet einen Fehler. Die EF-Core-Version im Beispiel behält das alte Verhalten mit einem Wertkonverter bei, denn ein Bibliothekswechsel darf Beträge nicht verändern. Ob Abschneiden fachlich gewollt ist, ist eine eigene Entscheidung, aber es sollte eine Entscheidung sein.

Die Unterschiede, die Ihre Tests nicht zeigen

Zwei weitere Auslassungen sind die gefährlichen. Bleibt der Typ der Datumsspalte beim Standard von EF Core oder erhalten Schlüssel und Indizes die Standardnamen von EF Core, bestehen weiterhin alle 17 Szenarien. Nichts sieht falsch aus. Das Problem zeigt sich später, wenn die erste echte EF-Core-Migration Spalten ändern und Objekte umbenennen will, die es unter diesen Namen nicht gibt.

Das Beispiel fängt das mit einer eigenen Prüfung ab, die das EF-Core-Modell mit dem Katalog der bestehenden Datenbank vergleicht: Spalten, Typen, Schlüssel, Fremdschlüssel, Indizes und Namen. Wenn Sie aus diesem Artikel nur einen Gedanken mitnehmen, dann diesen: Funktionale Tests reichen für diese Migration nicht aus.

Eine Änderung zum Besseren

Es gibt auch einen Unterschied in die andere Richtung. Die Suche nach einem Auftrag über einen exakten Zeitpunkt mit Millisekunden findet in der EF6-Version nichts und in der EF-Core-Version den Auftrag, weil die beiden Bibliotheken den Wert in unterschiedlichen Typen an die Datenbank senden. Der Wechsel repariert also eine Suche, die stillschweigend nie funktioniert hat. Eine Verhaltensänderung ist es trotzdem, und sie ist als Test festgehalten.

Was das Beispiel nicht belegt

Die Performance wurde nicht gemessen. Die beiden Versionen liefen nicht parallel gegen eine Datenbank, auch wenn das unveränderte Schema das zulassen sollte. EDMX-Modelle, das Mapping gespeicherter Prozeduren und andere Datenbanken als SQL Server liegen außerhalb des Beispiels. Jeder dieser Punkte braucht in einem echten Projekt eine eigene Prüfung.

Wie sich der Aufwand abschätzen lässt

Die Größe des Modells sagt wenig aus. Aussagekräftiger sind diese Zahlen:

  • Navigationseigenschaften, die ohne ausdrückliches Laden gelesen werden. Jede ist eine Stelle, an der Lazy Loading ersetzt werden muss.
  • Direkte SQL-Aufrufe und EF6-spezifische Funktionen in LINQ-Abfragen. Sie werden einzeln umgeschrieben.
  • Spalten, bei denen es auf Genauigkeit ankommt: Geldbeträge, Mengen, Datumswerte mit Uhrzeit.
  • EDMX und das Mapping gespeicherter Prozeduren, falls vorhanden.
  • Vorhandene Tests, die gegen eine echte Datenbank laufen. Fehlen sie, besteht die erste Aufgabe darin, sie gegen die EF6-Version zu schreiben.

Eine sichere Reihenfolge

  1. Szenarien gegen die bestehende EF6-Datenschicht schreiben und auf einem echten Datenbankserver ausführen, nicht auf einem In-Memory-Ersatz.
  2. Das bestehende Schema als Skript erzeugen und als Referenz in die Versionsverwaltung legen.
  3. Das EF-Core-Modell aufbauen und das Mapping ausschreiben, bis ein Schemavergleich keine Abweichung mehr meldet.
  4. Dieselben Szenarien gegen die EF-Core-Version kompilieren und beheben, was fehlschlägt: Ladeverhalten, Abfragen, Wertkonvertierungen.
  5. Eine leere Baseline-Migration anlegen, damit EF Core auf der bestehenden Datenbank aufsetzt und nicht versucht, sie neu zu erstellen.
  6. Jede gewollte Verhaltensänderung als Test festhalten und ausliefern.

Fazit

Entity Framework 6 muss nicht zu einem festen Termin ersetzt werden, und gerade deshalb verdient die Migration eine bewusste Entscheidung. Wenn die Anwendung weiterlebt und aktiv entwickelt wird, ist EF Core die bessere Grundlage, und der Wechsel gelingt auf der bestehenden Datenbank, ohne das Schema anzufassen. Das Risiko liegt nicht in den Fehlern, die Sie am ersten Tag sehen, sondern in den Unterschieden, bei denen jeder Test besteht.

Wenn Sie eine zweite Meinung zu Ihrer Datenschicht möchten, bietet unser Team eine Analyse im Rahmen unserer Leistungen zur Migration von Entity Framework 6 zu EF Core an. Sie können auch mit dem Code beginnen: Das Beispiel auf GitHub lässt sich mit dem .NET SDK und einem SQL-Server-Container bauen und ausführen.

Wir verwenden technisch notwendige Cookies, um die einwandfreie Funktion unserer Website sicherzustellen. Mit Ihrer Einwilligung verwenden wir außerdem optionale Cookies für Analysezwecke und weitere Funktionen. Sie können alle Cookies akzeptieren, optionale Cookies ablehnen oder Ihre Einstellungen individuell anpassen. Weitere Informationen finden Sie in unserer Cookie-Richtlinie.