SwiftData Migrations
Zusammenfassung
Kurz
Der Artikel erklärt SwiftData-Migrationen anhand dreier Todo-Schemaversionen und stellt `VersionedSchema`, `MigrationStage` und `SchemaMigrationPlan` vor. Der Autor empfiehlt, zunächst nicht versionierte Modelle zu verwenden; seine Einschätzung, dass meist keine manuelle Migration nötig sei, wird im Beitrag nicht durch Tests oder Messdaten belegt.
Mittel
Der Artikel beschreibt SwiftDatas Umgang mit Änderungen am Datenschema und zeigt, wie Migrationen bei Bedarf ausdrücklich versioniert werden. Der Autor meint, dass SwiftData viele übliche Änderungen automatisch bewältige; die Aussage, dies gelte für „99 Prozent“ der Fälle, ist eine Einschätzung und wird nicht durch Messdaten belegt.
Für explizite Migrationen schlägt der Beitrag drei Bausteine vor: `VersionedSchema` hält einzelne Modellstände fest, `MigrationStage` beschreibt den Übergang zwischen zwei Ständen und ein `SchemaMigrationPlan` bündelt Versionen und Übergänge. Anhand eines Todo-Modells zeigt er das Hinzufügen eines `content`-Felds und die spätere Umbenennung von `done` zu `isDone`. Leichte Migrationen ordnet er typischen Schemaänderungen zu; benutzerdefinierte Migrationen sollen Daten umformen oder übertragen. Als Beispiel soll der bisherige Titel beim Ergänzen des Inhaltsfelds übernommen werden.
Empfohlen wird, zunächst mit nicht versionierten Modellen zu beginnen: Ein Wechsel zu Versionen sei möglich, die Rückkehr könne die Migrationskette brechen. Versionierte Modelle erforderten zudem explizite Übergänge und Wiederholungen der Modelle. Der Text bietet Codebeispiele und WWDC-Verweise, aber keine dokumentierten Tests oder Ergebnisse aus einer konkreten App.
Ausführlich lesen
Der Artikel erklärt, wann SwiftData-Schemamigrationen Entwicklerinnen und Entwicklern Arbeit abnehmen können und wie man Migrationen bei Bedarf selbst steuert. Der Autor schätzt, dass für die meisten Fälle keine ausdrücklich selbst verwalteten Migrationen nötig seien: Man ändere die Modelle, und SwiftData gleiche das aktuelle Schema mit dem gespeicherten ab. Für Sonderfälle stellt der Beitrag einen Ablauf mit `VersionedSchema`, `MigrationStage` und `SchemaMigrationPlan` vor. Die Einschätzung „99 Prozent“ ist eine zugespitzte Empfehlung des Autors, keine im Text belegte Messung.
Zur Einordnung unterscheidet der Artikel gewöhnliche Migrationen, bei denen Änderungen etwa als SQL-Anweisungen festgehalten werden, von schemaorientierten Abläufen: Dort wird das Schema angepasst und eine Migration aus dem Unterschied zur vorherigen Version abgeleitet. Solche automatisch erzeugten Migrationen müssten laut Beitrag gegebenenfalls geprüft oder verändert werden. SwiftData wird als auf diesem Prinzip aufbauend beschrieben.
Das Codebeispiel beginnt mit einem einfachen Todo-Modell und einem `ModelContainer`. Für eine explizite Migrationsgeschichte werden die Modelle anschließend in zeitlich geordnete Schemas eingeschlossen, deren Reihenfolge über Versionsnummern festgelegt wird. Der Artikel zeigt drei Stände: Version 1 enthält Titel, Erstellungsdatum und Erledigt-Status; Version 2 ergänzt ein Textfeld `content`; Version 3 benennt `done` in `isDone` um und kennzeichnet den früheren Namen mit `@Attribute(originalName:)`.
Zwischen je zwei Schemafassungen soll eine Migrationsstufe liegen. Der Beitrag unterscheidet leichte Migrationen für häufige Schemaänderungen, darunter Umbenennen und Löschen von Eigenschaften sowie das Hinzufügen optionaler oder mit Standardwert versehener Eigenschaften. Benutzerdefinierte Migrationen empfiehlt er für Datenumformungen, etwa das Aufteilen eines Feldes oder das Übertragen von Werten zwischen Modellen. Im Beispiel soll eine benutzerdefinierte Migration beim Übergang von Version 1 zu 2 den bisherigen Titel als Inhalt übernehmen; die Umbenennung von Version 2 zu 3 wird als leichte Migration dargestellt.
Ein `SchemaMigrationPlan` bündelt die Versionen und Übergänge. Beim Erstellen des Containers wird dann das neueste Schema angegeben und der Plan an `ModelContainer` übergeben. Der Artikel empfiehlt dennoch, zunächst mit nicht versionierten Modellen zu arbeiten. Der Wechsel zu einem versionierten Schema lasse sich durch Einführen einer ersten Version vornehmen; der Rückweg zu einer nicht versionierten Einzelfassung könne dagegen die Migrationskette brechen. Außerdem müsse man nach dem Wechsel explizite Stufen auch für leichte Migrationen definieren und Modelle in den Versionen wiederholen.
Der Text ist eine kompakte Einführung mit Swift-Beispielen und Verweisen auf zwei WWDC-Vorträge. Er berichtet keine Tests, Messwerte oder Vergleichsergebnisse. Die Beispiele veranschaulichen den vorgesehenen Aufbau, belegen aber nicht, dass eine Migration in einer konkreten App erfolgreich ausgeführt wurde.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Lunas kurze und mittlere Zusammenfassung wurden gemeinsam bewertet; beide geben den Bericht sachlich treu wieder und erfinden nichts. Die Einordnungen beruhen auf dem Bericht, die Sammelfragen sind jeweils nur teilweise beantwortet.
Im Bericht, aber nicht in der Zusammenfassung
- Die Unterscheidung zwischen lightweight- und custom-Migrationen fehlt in der kurzen Fassung
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Vertrauen in Modelle
- SF-V5 Was soll heute für das Verhalten und den Betrieb von Modellen gelten?
- clef 100 %kein Bezug
- Luna 25 %Hintergrund, keine Belege
- JEV 28 %beantwortet teilweise oder widerspricht
- amos 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung beantwortet teilweise oder widerspricht
Modelle teilen und schützen
- SF-H3 Wie lässt sich nachverfolgen, woraus ein Modell entstanden ist und was in ihm steckt?
- clef 100 %kein Bezug
- Luna 46 %Hintergrund, keine Belege
- JEV 29 %beantwortet teilweise oder widerspricht
- amos 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung beantwortet teilweise oder widerspricht