#Migrations-Manager

This feature is provided by the plugin «Migrationsmanager», included in Professional Edition and above commercial editions

#Einführung

Er dient dazu, Anwendungskonfigurationen von einer Anwendungsumgebung in eine andere zu übertragen. Der Migrations-Manager konzentriert sich dabei primär auf die Migration von Anwendungskonfigurationen. Benötigen Sie eine vollständige Migration, empfehlen wir Ihnen, die Sicherungs- und Wiederherstellungsfunktionen des „Backup-Managers“ zu nutzen.

#Installation

Der Migrations-Manager ist vom Backup-Manager Plugin abhängig. Bitte stellen Sie sicher, dass dieses Plugin bereits installiert und aktiviert ist.

#Ablauf und Prinzipien

Der Migrations-Manager überträgt Tabellen und Daten aus der Hauptdatenbank, basierend auf festgelegten Migrationsregeln, von einer Anwendungsinstanz in eine andere. Beachten Sie, dass Daten aus externen Datenbanken oder Sub-Anwendungen nicht migriert werden.

#Migrationsregeln

#Integrierte Regeln

Der Migrations-Manager kann alle Tabellen in der Hauptdatenbank migrieren. Dabei werden derzeit die folgenden fünf Regeln unterstützt:

• Nur Struktur: Es wird nur die Struktur (Schema) der Tabellen migriert – es werden keine Daten eingefügt oder aktualisiert.
• Überschreiben (leeren und neu einfügen): Alle vorhandenen Datensätze aus der Zieldatenbanktabelle werden gelöscht und anschließend die neuen Daten eingefügt.
• Einfügen oder Aktualisieren (Upsert): Es wird geprüft, ob ein Datensatz (anhand des Primärschlüssels) bereits existiert. Falls ja, wird der Datensatz aktualisiert; falls nein, wird er eingefügt.
• Einfügen ignorieren bei Duplikat: Neue Datensätze werden eingefügt. Existiert ein Datensatz (anhand des Primärschlüssels) bereits, wird der Einfügevorgang ignoriert (es erfolgen keine Aktualisierungen).
• Überspringen: Die Verarbeitung für die Tabelle wird vollständig übersprungen (keine Strukturänderungen, keine Datenmigration).

Hinweise:

• Die Regeln „Überschreiben“, „Einfügen oder Aktualisieren“ und „Einfügen ignorieren bei Duplikat“ synchronisieren ebenfalls Änderungen an der Tabellenstruktur.
• Wenn eine Tabelle einen automatisch inkrementierenden Primärschlüssel verwendet oder keinen Primärschlüssel besitzt, können die Regeln Einfügen oder Aktualisieren und Einfügen ignorieren bei Duplikat nicht angewendet werden.
• Die Regeln Einfügen oder Aktualisieren und Einfügen ignorieren bei Duplikat nutzen den Primärschlüssel, um festzustellen, ob ein Datensatz bereits existiert.

#Detailliertes Design

#Konfigurationsoberfläche

Migrationsregeln konfigurieren

Unabhängige Regeln aktivieren

Unabhängige Regeln und die Tabellen auswählen, die von den aktuellen unabhängigen Regeln verarbeitet werden sollen

#Migrationsdateien

#Eine neue Migration erstellen

#Eine Migration ausführen

Überprüfung der Anwendungsumgebungsvariablen (Erfahren Sie mehr über Umgebungsvariablen)

Fehlen welche, wird ein Pop-up-Fenster den Benutzer auffordern, die benötigten neuen Umgebungsvariablen hier einzugeben und dann fortzufahren.

#Migrationsprotokolle

#Rollback

Bevor eine Migration ausgeführt wird, wird die aktuelle Anwendung automatisch gesichert. Schlägt die Migration fehl oder entsprechen die Ergebnisse nicht den Erwartungen, können Sie über den Backup-Manager ein Rollback durchführen und den vorherigen Zustand wiederherstellen.