---
title: "Datenmigration in Drupal: CSV, JSON, API"
lang: de
type: knowledge
canonical: https://www.arocom.de/wissen/drupal/datenmigration
alternate: https://www.arocom.de/en/knowledge/drupal/data-migration
author: "Axel Roth"
last_updated: 2026-10-31
---

# Datenmigration in Drupal: CSV, JSON, API

Drupals Migrate-Framework überführt Inhalte aus CSV-Dateien,
JSON-Feeds, XML-Dokumenten und REST-APIs in strukturierte
Drupal-Inhaltstypen. Der Prozess ist wiederholbar, versionierbar
und testbar. arocom hat seit 2012 Migrationen für Projekte mit
hunderten bis hunderttausenden Datensätzen umgesetzt und den
Prozess standardisiert.

## Datenmigration in Drupal: CSV, JSON, API

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ässig 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.

![Drupal Migrate API, Source, Process, Destination](https://www.arocom.de/images/screenshots/wissen/drupal/datenmigration.webp)

*Drupal Migrate folgt einer dreigliedrigen Pipeline: Source → Process → Destination.*

## 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. Für den Umstieg von TYPO3 bieten wir eine
[eigene Migrations-Leistung](https://www.arocom.de/leistungen/typo3-zu-drupal) an.

**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 Quelldaten, 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](https://www.arocom.de/zukunfts-check)
bewertet den Migrationsaufwand. Ab 2.500 EUR zzgl. MwSt.,
anrechenbar auf das Folgeprojekt.

- [Drupal Upgrade anfragen](https://www.arocom.de/leistungen/drupal-upgrade)

**Aus arocom-Projekten:**

- Bei COFAD war die Herausforderung nicht die Technik, sondern die Vernetzung: Berater, Projekte, Themen, alles miteinander verlinkt, alles durchsuchbar. Drupal 11 mit 20 maßgeschneiderten Modulen, Search-API-Index und Entity-Browser-Workflow macht das heute zum Tagesgeschäft.
- Manchmal ist 'weniger Drupal' die richtige Antwort: für die Venues-DB von d&b haben wir bewusst nur 4 Custom-Module geschrieben, dafür auf Standard-Module gesetzt (Entity Browser, Imagemagick). Die Plattform ist heute fast wartungsfrei und überlebt jede Drupal-Major-Version mit minimalem Aufwand.

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

## Weiterlesen

- [Agenturwechsel](https://www.arocom.de/agenturwechsel): Den Wechsel strukturiert planen
- [SEO beim Relaunch](https://www.arocom.de/wissen/seo-geo/seo-relaunch): Rankings beim Relaunch sichern
- [Drupal erklärt](https://www.arocom.de/wissen/drupal/was-ist-drupal): Was Drupal ist und was nicht