Customizing
Customizing
Breadcrumbs

Datenbank-Export/-Import


Informationen

  • Durch den Datenbank-Export wird eine Kopie der Daten aus der Datenbank erzeugt und in einer Datei gespeichert.

  • Mit dem Datenbank-Import kann diese Datei in ein PLANTA-System eingelesen werden (Voraussetzung: Das Schema entspricht dem Schema des Quellsystems).

  • Der Datenbank-Export/-Import wird von Customizing-Deployment und Datenbank-Update verwendet.

Hinweise

  • Die Datenbankverbindung etc. wird aus der Konfiguration des PLANTA-Servers verwendet.

  • Der Export kann auf das vollständige PLANTA Data Dictionary zugreifen und daher entscheiden, welche Schemas, Tabellen und Spalten aktiv sind.

    • Sofern keine konkreten Datentabellen und/oder Schemas ausgewählt sind, werden alle aktiven Daten exportiert.

  • Da der Schema-Export analog vorgeht, passen exportierte Schemas und Daten desselben Customizing-Standes exakt zusammen.

Anwendung

Information

  • Die Werkzeuge können über ein command in der docker compose aufgerufen werden und haben dieselben Anforderungen an die Systemumgebung wie der PLANTA-Server selbst, wenngleich einen deutlich geringeren Speicherbedarf.

Export

Aufruf durch command: ["export", "<parameter>"].

Options: -L, --exclude-licenses List of licenses to exclude -S, --exclude-schemas List of schemas to exclude -T, --exclude-tables List of tables to exclude (SQL names, not table numbers) -f, --full Include everything -h, --help Display this help message -l, --include-licenses List of licenses to include -s, --include-schemas List of schemas to include -t, --include-tables List of tables to include (SQL names, not table numbers) * -o, --output-file Output file to write export to -H, --with-history Transfer history tables and REVINFO as well Default: false

Import

Aufruf durch command: ["import", "<parameter>"].

Options: -L, --exclude-licenses List of licenses to exclude -S, --exclude-schemas List of schemas to exclude -T, --exclude-tables List of tables to exclude (SQL names, not table numbers) -f, --full Include everything -h, --help Display this help message -l, --include-licenses List of licenses to include -s, --include-schemas List of schemas to include -t, --include-tables List of tables to include (SQL names, not table numbers) * -i, --input-file Input file to read import from -j, --jobs List of @par files to treat like a separate job each --truncate truncate all tables about to receive data prior to actual import -H, --with-history Transfer history tables and REVINFO as well Default: false

Parameterdetails

Die Kommandozeilenparameter für die Auswahl der Datenmenge sind bei Export und Import identisch.

Parametername

Parameter

Kurzschreibweise

Erläuterung

Schemafilter

--include-schemas und
--exclude-schemas

-s
-S

Erlauben Positiv- bzw. Negativlisten von PLANTA-Schemas, z.B. Q1B Q2B.

Tabellenfilter

--include-tables und
--exclude-tables

-t
-T

Erlauben Positiv- bzw. Negativlisten von PLANTA-Datentabellen, z.B. DT412 DT415 MIGRATIONRULE MIGRATIONHISTORY.

Lizenzfilter

--include-licenses und
--exclude-licenses

-l
-L

Erlauben Positiv- bzw. Negativlisten von PLANTA-Lizenzen, z.B. 011 100.
Der Lizenzfilter verhält sich im Import bzw. Export unterschiedlich (weitere Informationen).

History

--with-history

-H

Aktiviert den Transfer der History-Tabellen und der Tabelle REVINFO.

  • Die Migration der Historisierung befindet sich noch in der Entwicklung und ist derzeit weder notwendig noch empfehlenswert.

  • Im Wesentlichen ist zu beachten, dass nach erfolgtem Transfer inkl. History der Zählerstand der sequence HIBERNATE_SEQUENCE im Zielsystem auf das Maximum des Standes von Quell- und Zielsystem gesetzt werden muss, um Kollisionen zu vermeiden, die sich durch eine Unique-Constraint-Verletzung äußern.

  • Default: false

Export-Datei

--output-file

-o

Datei, in die der Export geschrieben wird.

Import-Datei

--input-file

-i

Datei, die beim Import eingelesen wird.

Jobs

--jobs

-j

Angabe mehrerer Datenbank-Export/-Import#Parameterdateien, die nacheinander als Jobs abgearbeitet werden.

  • Damit werden einmalig Trigger und Constraints deaktiviert und im Nachgang wieder aktiviert, und zwischenzeitlich alle Parameterdateien exakt so abgearbeitet, als hätte man den Import separat mit @<Datei> aufgerufen.

  • Hierbei ist es derzeit noch erforderlich, zusätzlich zu den Jobs eine Eingabedatei anzugeben, die aber nicht verarbeitet wird. Jede Job-Parameterdatei muss ihre Eingabedatei selbst spezifizieren.

Truncate

--truncate


Leert die Tabellen vor dem Import.

Hilfe

--help

-h

Gibt eine Liste der möglichen Parameter aus.

Unterschiede der Behandlung von Filteroptionen zwischen Import und Export

Informationen

  • Schema-, Tabellen-, und Historyfilter arbeiten bei Import und Export identisch, d.h. ein vollständiger Export eines Entwicklungssystems kann z.B. auch für ein Customizing-Deployment im zugehörigen Produktivsystem herangezogen werden.

  • Generell gilt hier: Sofern der Export die gewünschten Daten enthält, kann der Import sie selektiv verarbeiten.

  • Im Gegensatz dazu können Lizenzfilter beim Import nicht auf die exportierten Daten angewandt werden.

  • Alle Zeilen, die der Export enthält, werden beim Import verarbeitet, ungeachtet derer Lizenznummer.

    • Hier muss also der Export zum gewünschten Import passen, was z.B. beim Customizing-Update gilt.

    • (Ein vollständiger Export aller Schemas und Tabellen mit richtigem Lizenzfilter kann jedoch wiederum durch passende Schema- und Tabellenauswahl für ein Customizing-Update Verwendung finden.)

  • Der Lizenzfilter beim Import bestimmt lediglich, welche Datensätze vor dem Einlesen der Daten in den jeweiligen Tabellen gelöscht werden sollen (Positivliste durch --include-licenses) oder eben nicht gelöscht werden dürfen (Negativliste, --exclude-licenses), unter der Annahme, dass der Export genau die Daten mit den zu verarbeitenden Lizenzen vollständig mitbringt.

Import-Besonderheiten

Hinweis

  • Werden beim Import im System Datensätze identifiziert, die die gleichen Primärschlüssel aufweisen wie die Datensätze, die importiert werden, werden die bestehenden Datensätze gelöscht.

Parameterdateien

Informationen

  • Sämtliche Kommandozeilenoptionen können für sich wiederholende Aufgaben in Parameterdateien gespeichert und mit der @<Datei> -Syntax verwendet werden.

  • Anwendungsbeispiele siehe Customizing-Deployment - hierfür werden bisweilen in erster Linie Parameterdateien zur Verfügung gestellt.

  • Bei der Erstellung einer Parameterdatei ist zu beachten, dass der Parser die Argumente anhand von Zeilenumbrüchen trennt:

# funktioniert: --include-schemas Q1B Q2B # funktioniert nicht: --exclude-tables DT345