> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-de/pipeline/pipeline-operationen/pipeline-operation-daten-migrieren.md). # Pipeline-Operation: Daten migrieren {% hint style="warning" %} #### Geschrieben für die alte Benutzeroberfläche Dieser Artikel wurde für die alte Benutzeroberfläche geschrieben. Die Anweisungen sind weiterhin verwendbar, aber die Screenshots sind veraltet. In einigen Fällen wurden die in den Anweisungen genannten Elemente verschoben oder geändert. Wenn Sie ein Element nicht finden können, siehe den [Wo ist es hin](/devops/devops-de/ubergang-zur-neuen-ui-ux/wo-ist-es-hin.md) Artikel. {% endhint %} ## ![](https://578823411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Übersicht Die **Daten migrieren** Der Vorgang führt einen Data-Migrator-Migrationsauftrag als Schritt in einer DevOps-Pipeline aus. Er überträgt Datensätze zwischen einer Quell- und einer Zielorganisation mithilfe einer Data-Migrator-Vorlage, sodass Sie Daten während einer Pipeline automatisch verschieben können, statt danach eine Migration manuell auszuführen. Da die Migration in der Data-Migrator-App ausgeführt wird, verwendet der Vorgang Ihre vorhandenen Vorlagen. Diese Vorlagen legen fest, welche Objekte und Datensätze übertragen werden, einschließlich aller Filter und Datensatzzuordnungen. {% hint style="info" %} #### Bewährte Methoden * Testen Sie Ihre Data-Migrator-Vorlage in der Data-Migrator-App, bevor Sie sie zu einer DevOps-Pipeline hinzufügen. * Verwenden Sie diesen Vorgang, um eine Zielorganisation nach einer Bereitstellung mit Konfigurations- oder Referenzdaten zu befüllen. * Halten Sie Datensätze über alle Umgebungen hinweg konsistent, indem Sie einen Vorgang zum Daten migrieren einschließen. * Verwenden Sie in Ihrer Vorlage die Datensatzzuordnung für wiederholte Migrationen, um das Duplizieren von Daten zu vermeiden. * Wenden Sie in Ihrer Data-Migrator-Vorlage eine Datenmaskierung an, um sensible Daten durch zufällige Seed-Werte zu ersetzen und sicherzustellen, dass in der Zielorganisation keine echten Daten erscheinen. {% endhint %} ### Voraussetzungen für Data Migrator Bevor Sie einen Vorgang zum Daten migrieren hinzufügen, müssen Sie in der Data-Migrator-App mehrere Elemente konfigurieren. In den folgenden Abschnitten werden diese Voraussetzungen beschrieben und auf zugehörige Artikel verwiesen. ### Vorlage Jede Datenmigration wird anhand einer Vorlage ausgeführt, die festlegt, welche Objekte und Datensätze migriert werden, einschließlich aller Filter und Datensatzzuordnungen. Vergewissern Sie sich, dass eine Vorlage die richtigen Datensätze kopiert, bevor Sie sie in einem automatisierten Prozess wie einer Pipeline verwenden. Weitere Informationen zu Data-Migrator-Vorlagen finden Sie in den folgenden Artikeln. * [Übersicht über Vorlagen](/data-migrator/data-migrator-de/vorlagen/vorlagen-designer/ubersicht-uber-vorlagen.md) * [Eine Vorlage erstellen](/data-migrator/data-migrator-de/vorlagen/vorlagen-designer/eine-vorlage-erstellen.md) * [Objekte zu einer Vorlage hinzufügen](/data-migrator/data-migrator-de/vorlagen/vorlagen-designer/objekte-zu-einer-vorlage-hinzufugen.md) * [Felder zu Objekten hinzufügen](/data-migrator/data-migrator-de/vorlagen/vorlagen-designer/felder-zu-objekten-hinzufugen.md) * [Filter zu Objekten hinzufügen](/data-migrator/data-migrator-de/vorlagen/vorlagen-designer/filter-zu-objekten-hinzufugen.md) * [Objektdatensatzzuordnung festlegen](/data-migrator/data-migrator-de/vorlagen/vorlagen-designer/objektdatensatzzuordnung-festlegen.md) #### Organisationen Eine Datenmigration kann nur zwischen Organisationen ausgeführt werden, denen die Data-Migrator-App zugewiesen ist. Wenn eine Organisation, die Sie verwenden möchten, nicht aufgeführt ist, weisen Sie ihr Data Migrator in der App Globale Einstellungen zu. Weitere Informationen finden Sie im folgenden Artikel zum Zuweisen von Apps zu Organisationen. * [Eine App einer Organisation zuweisen](/global-settings/global-settings-docs-de/umgebung/organisationen/eine-app-einer-organisation-zuweisen.md) ### Vorgang „Daten migrieren“ vs. Data-Migrator-Migration Da der Vorgang „Daten migrieren“ Data Migrator zum Erstellen und Ausführen der Migration verwendet, sind die Endergebnisse identisch. Es gibt jedoch einen wichtigen Unterschied zwischen den beiden. In Data Migrator ist eine Migration ein mehrstufiger Prozess, der das Erstellen, Überprüfen und Ausführen der Migration umfasst. In einer DevOps-Pipeline ist der Vorgang „Daten migrieren“ ein einzelner Prozess, der sowohl das Erstellen als auch die Ausführung der Migration automatisiert. Da eine Pipeline automatisiert ist, wird der Überprüfungsschritt übersprungen. Vergewissern Sie sich daher, dass die Migration korrekt funktioniert, bevor Sie sie in eine kritische Pipeline aufnehmen. ## Konfiguration des Vorgangs „Daten migrieren“ {% hint style="info" %} Die folgenden Anweisungen gelten für die Konfiguration dieser Pipeline-Operation. Allgemeine Anweisungen zum Hinzufügen eines Pipeline-Schritts und zum Festlegen des nächsten Schritts finden Sie im folgenden Artikel. [Einen Pipeline-Schritt hinzufügen](/devops/devops-de/pipeline/pipeline-schritte-konfigurieren/einen-pipeline-schritt-hinzufugen.md) {% endhint %} {% stepper %} {% step %} ### Vorgang und Auftragsname auswählen 1. Klicken Sie auf das **Vorgang** Dropdown-Menü. 2. Auswählen **Daten migrieren**.
3. Geben Sie im **Feld „Auftragsname“** einen Namen für den in Data Migrator auszuführenden Migrationsauftrag ein.
{% endstep %} {% step %} ### Quell- und Zielorganisationen auswählen {% hint style="info" %} Nur Organisationen, denen die Data-Migrator-App zugewiesen ist, stehen als Quellen und Ziele für die Datenmigration zur Verfügung. Wenn Sie Daten zu oder von einer Organisation migrieren möchten, der nur DevOps zugewiesen ist, weisen Sie dieser Organisation zuerst Data Migrator in der App Globale Einstellungen zu. Weitere Informationen finden Sie im folgenden Artikel zum Zuweisen von Apps zu Organisationen. * [Eine App einer Organisation zuweisen](/global-settings/global-settings-docs-de/umgebung/organisationen/eine-app-einer-organisation-zuweisen.md) {% endhint %} 1. Klicken Sie auf das **Quellorganisation** Dropdown-Menü. 2. Wählen Sie die Organisation aus, die als Quelle der Migration verwendet werden soll.
3. Klicken Sie auf das **Zielorganisation** Dropdown-Menü. 4. Wählen Sie die Organisation aus, die als Ziel der Migration verwendet werden soll. {% endstep %} {% step %} ### Data-Migrator-Vorlage auswählen {% hint style="info" %} Da Sie Data-Migrator-Vorlagen in DevOps nicht anzeigen können, müssen Sie den Namen der Data-Migrator-Vorlage kennen, die Sie für diese Migration verwenden möchten. Wenn Sie sich nicht sicher sind, öffnen Sie Data Migrator, um den richtigen Vorlagennamen zu finden. Weitere Informationen zu Data-Migrator-Vorlagen finden Sie im folgenden Artikel. * [Übersicht über Vorlagen](/data-migrator/data-migrator-de/vorlagen/vorlagen-designer/ubersicht-uber-vorlagen.md) {% endhint %} 1. Klicken Sie auf das **Vorlage** Dropdown-Menü. 2. Wählen Sie die Vorlage aus, die für die Datenmigration verwendet werden soll.
{% endstep %} {% endstepper %} ## Ergebnisse der Datenmigration {% hint style="info" %} Sobald eine Pipeline gestartet wurde, können ihr Fortschritt und ihre Ergebnisse von der **Aktivitäten** Registerkarte des Branches aus angezeigt werden, der die Pipeline ausgeführt hat. Die folgenden Anweisungen zeigen Ihnen, wie Sie die Ergebnisse dieses Vorgangs überprüfen. Allgemeine Anweisungen zum Zugriff auf Pipeline-Ergebnisse vom Branch aus finden Sie im folgenden Artikel. * [Pipeline-Ergebnisse anzeigen](/devops/devops-de/pipeline/pipeline-aktionen/pipeline-ergebnisse-anzeigen.md) {% endhint %} {% stepper %} {% step %} ### Zusammenfassung und Protokoll Sobald der Daten-migrieren-Job abgeschlossen ist, können Sie die Ergebniszusammenfassung anzeigen, indem Sie den **Daten migrieren** Schritt aus den Pipeline-Ergebnissen auswählen.
Die **Zusammenfassung** der Ergebnisse der Datenmigration zeigt die folgenden Informationen an:
FelderBeschreibung
Status

Abgeschlossen wenn der Migrationsauftrag beendet ist. Eine Migration gilt weiterhin als abgeschlossen, selbst wenn sie Fehlgeschlagene Datensätze.

Ausnahme wenn ein Problem verhindert hat, dass der Migrationsauftrag ausgeführt wird. Überprüfen Sie die Protokolle, um das Problem zu beheben.

DauerDie Zeit, die der Migrate-Data-Job zum Abschließen benötigt hat, angezeigt in Stunden, Minuten und Sekunden.
Datum des Starts/EndesDas Datum und die Uhrzeit, zu denen der Migrate-Data-Job gestartet und beendet wurde.
Gesamtanzahl der ObjekteGesamtzahl der in die Migration einbezogenen Objekte.
Gesamtanzahl der DatensätzeGesamtzahl der Datensätze in der Migration, einschließlich erfolgreicher und fehlgeschlagener Datensätze.
Fehlgeschlagene DatensätzeAnzahl der Datensätze, die nicht migriert werden konnten.
ProtokollProtokolleinträge für den Migrate-Data-Job. Verwenden Sie das Protokoll, um den Status des Auftrags und etwaige Fehlermeldungen zu überprüfen.
Beispiel für ein Migrate-Data-Protokoll: {% code overflow="wrap" expandable="true" %} ``` [1. Jun. 2026, 16:00 Uhr]: [info] Auftrag gestartet [1. Jun. 2026, 16:02 Uhr]: [info] Auftrag abgeschlossen ``` {% endcode %} {% endstep %} {% step %} ### Ergebnisse anzeigen Um weitere Details zur Migration anzuzeigen, öffnen Sie die Ergebnisse. 1. Klicken Sie **Ergebnis anzeigen**.
2. Ein neuer Data-Migrator-Tab wird geöffnet und zeigt die Ergebnisse des Migrationsauftrags an.
3. Ausführliche Anweisungen zum Überprüfen der Migrationsergebnisse finden Sie im folgenden Artikel. 1. [Migrationsergebnisse anzeigen](/data-migrator/data-migrator-de/verlauf/migrationsergebnisse-anzeigen.md) {% hint style="info" %} Sie können eine Datenmigration in der Data-Migrator-App zurücksetzen. Anweisungen finden Sie im folgenden Artikel. * [Eine Migration rückgängig machen](/data-migrator/data-migrator-de/verlauf/eine-migration-ruckgangig-machen.md) {% endhint %} {% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.flosum.com/devops/devops-de/pipeline/pipeline-operationen/pipeline-operation-daten-migrieren.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.