Datenmigration in Drupal: CSV, JSON, API
Zuletzt aktualisiert: März 2026 · Lesezeit: 7 Minuten
Ein neues CMS ist nur so gut wie die Daten darin. Ob ihr von einem Altsystem migriert, Produktdaten aus einem PIM übernehmt oder Standortdaten aus einer Excel-Tabelle importiert — Drupals Migrate-Framework macht den Prozess zuverlässigig und wiederholbar.
Das Migrate-Framework im Überblick
Drupals Migrate-System arbeitet in drei Phasen:
Source. Definiert die Datenquelle: CSV-Datei, JSON-Feed, Datenbank, REST-API oder XML-Dokument. Für jede Quelle gibt es Source-Plugins.
Process. Transformiert die Daten: Felder umbenennen, Werte umrechnen, Referenzen auflösen, Taxonomien zuordnen. Process-Plugins sind kombinierbar und erweiterbar.
Destination. Legt fest, wohin die Daten geschrieben werden: Nodes, Taxonomie-Terme, Benutzer, Medien oder andere Drupal-Entitäten.
Migration in der Praxis
CSV-Import. Der häufigste Fall: Daten liegen als Excel-Export in CSV vor. Das Migrate-Source-CSV-Plugin liest die Datei zeilenweise und ordnet Spalten den Drupal-Feldern zu.
JSON/API-Import. Daten aus externen Systemen — PIM, ERP, CRM — werden über REST-APIs abgerufen und in Drupal-Inhalte umgewandelt. Das funktioniert einmalig oder als regelmäßiger Sync.
CMS-Migration. Inhalte aus WordPress, TYPO3 oder anderen CMS werden über deren Datenbank oder Export-Formate übernommen. Drupal bringt spezielle Source-Plugins für gängige CMS mit.
Wiederholbarkeit. Migrationen sind als YAML-Konfiguration gespeichert und versioniert. Sie können beliebig oft ausgeführt werden — zum Testen, Korrigieren und final Übernehmen.
Best Practices für die Datenmigration
Daten bereinigen vor der Migration. Inkonsistente Daten erzeugen Fehler. Bereinigt die Qülldaten, bevor ihr migriert.
Schrittweise vorgehen. Startet mit einem kleinen Datensatz, prüft das Ergebnis und skaliert dann hoch. Debugging an 100 Datensätzen ist einfacher als an 100.000.
Rollback einplanen. Drupals Migrate-Framework unterstützt Rollbacks. Jede Migration kann rückgängig gemacht werden, ohne manuell aufzuräumen.
Migration geplant?
arocom plant und führt Datenmigrationen als Teil des Relaunch-Prozesses durch. Der Zukunfts-Check bewertet den Migrationsaufwand. Ab 2.500 EUR zzgl. MwSt., anrechenbar auf das Folgeprojekt.
Wie lange dauert eine Migration?
Die technische Umsetzung dauert wenige Tage bis Wochen, je nach Komplexität. Der größte Aufwand liegt in der Datenbereinigung und Mapping-Definition. arocom plant Migrationen als Teil des Projektplans.
Können Migrationen automatisiert laufen?
Ja. Für Szenarien, in denen Daten regelmäßig aus externen Systemen übernommen werden, können Migrationen als Cron-Job oder über Drush-Befehle automatisiert ausgeführt werden.
Was passiert mit Bildern und Dateien bei der Migration?
Bilder und Dateien werden als Medien-Entitäten migriert. Das Migrate-Framework lädt Dateien von der Quelle herunter und legt sie in Drupals Dateisystem ab. Metadaten wie Alt-Texte können mitmigriert werden.
Entdeckt einen zufälligen Artikel
Wie steht es um Drupal auf eurer Website? Der Zukunfts-Check zeigt in 2–4 Wochen, wo die größten Hebel liegen.
Drupal Zukunfts-Check
Checkliste: Ist eure Drupal-Installation zukunftsreif? 15 Prüfpunkte.
Kopiert diesen Prompt und fügt ihn in ChatGPT, Claude oder eine andere KI ein — ihr bekommt einen persönlichen Lernplan zu „Datenmigration in Drupal: CSV, JSON, API“.
Du bist ein erfahrener Coach für Drupal. Ich möchte das Thema "Datenmigration in Drupal: CSV, JSON, API" verstehen und p...War dieser Artikel hilfreich?