Für den Austausch von Datenbankinhalten zwischen unterschiedlichen Systemen stehen die Tools „Datenbankinhalt exportieren“ (expdbt) und „Datenbankinhalt importieren“ (impdbt) zur Verfügung.
In dieser Dokumentation wird das Tool „Datenbankinhalt importieren“ beschrieben. Das Tool für den Export der Datenbankinhalte ist in der Dokumentation „Datenbankinhalt exportieren“ beschrieben.
Zielgruppe
- System-Administratoren
- Technische Berater
Beschreibung
Mit dem Tool „Datenbankinhalte importieren“ (impdbt) können Sie den Datenbankinhalt einer Quelldatenbank in eine Zieldatenbank importieren. Dazu dienen XML-Dateien, die mit dem Tool „Datenbankinhalt exportieren“ aus der Quell-Datenbank exportiert wurden. Mit diesem Mechanismus können Sie beispielsweise Demo-Datenbanken für eine App, wie z. B. die App „Comarch Financials“ zwischen unterschiedlichen Systemen austauschen.
Ziel- und Quelldatenbank müssen vom gleichen Typ sein (OLTP-Datenbank, Repository-Datenbank etc.).
Wenn die Quell- und Zieldatenbank von unterschiedlichen Systemen stammen, dann können die Schemata und Versionen der Business Objects voneinander abweichen. Das Tool „Datenbankinhalt importieren“ kann in begrenztem Umfang abweichende Versionen von Business Objects konvertieren. Da das zu inkonsistenten Daten führen kann, sollten Sie nur für Demo- und Testdatenbanken eine Konvertierung der Daten erlauben. Nur nach einer sehr gründlichen Prüfung sollten Sie die Konvertierung für eine produktiv genutzte Datenbank verwenden.
Hinweis:
Wenn eine OLTP-Datenbank mithilfe der Tools „Datenbankinhalt exportieren“ (expdbt) und „Datenbankinhalt importieren“ (impdbt) von einem System zu einem anderen System übertragen wird, dann können Einträge im Änderungsjournal in der Ziel-Datenbank verloren gehen, wenn sich das Schema eines Business Entitys in den betroffenen Systemen unterscheidet.
Wenden Sie sich an Ihr Supportcenter, um prüfen zu lassen, ob eine individuelle Übernahme des Änderungsjournals möglich ist.
Befehl
Nachfolgend finden Sie den Befehl inklusive aller möglichen Parameter.
| impdbt | -db:<id> -d:<str> [-all] [-o:<str-1> … -o:<str-n>] [-p:<str-1> … -p:<str-n>] [-ignoreVersion] [-force] [-overwrite] [-verbose] [-threads:<int>] |
Parameter
Die Parameter des Befehls werden in der folgenden Tabelle erläutert. Die in eckigen Klammern gesetzten Parameter sind optional, die anderen hingegen sind Pflichtparameter. Für einige Parameter kann ein Stern (*) als Platzhalter angegeben werden, um damit alle möglichen Werte ausgeben zu können. Nicht alle Parameter können mehrfach genannt werden, nur die, die folgenden Zusatz an den Parametervariablen aufweisen, sind für die Mehrfachnennung zugelassen: „<str-1> … <str–n>“.
Der Parameter ist vollständig, z. B. –f<str>, und gemäß der Reihenfolge der Verwendung im Befehl aufzulisten.
| Parameter | Erläuterung |
| -db:<id> | Name der Zieldatenbank, in die die Inhalte importiert werden sollen. |
| -d | Angabe des Quell-Verzeichnisses, aus dem die Inhalte importiert werden sollen. Das Quell-Verzeichnis ist das Verzeichnis, das mithilfe des Tools „Datenbankinhalt exportieren“ erzeugt wurde.
Dieses Verzeichnis enthält die exportierten Datenbankinhalte der Quell-Datenbank. Kopieren Sie den Inhalt des Verzeichnisses vollständig, wenn Sie diesen Inhalt importieren möchten. |
| [-all] | Mit diesem Parameter werden alle Business Objects des Quell-Verzeichnisses importiert. |
| [-o:<str-1> … -o:<str-n>] | Parameter für den Import einzelner Business Objects mithilfe der vollqualifizierten Namen (Name und Namensraum). Wenn Sie an den Parameter die Zeichenfolge „#EXCLUDE“ anhängen, dann wird das Objekt nicht ausgewählt. „#EXCLUDE“ hat ein höheres Gewicht als die Auswahl eines Objekts.
Wenn Sie beispielsweise alle Objekte aus dem Namensraum „com.cisag.app.general.obj“ auswählen möchten bis auf das Business Object „Partner“, dann müssen Sie die folgenden Parameter kombinieren: -p:com.cisag.app.geneal.obj ‑o:com.cisag.app.geneal.obj.Partner#EXCLUDE Wenn Sie weder den Parameter -o noch -p verwenden, dann werden alle Business Objects importiert. |
| [-p:<str-1> … -p:<str-n>] | Parameter für den Import aller Business Objects eines Namensraumes. Wenn Sie an den Parameter die Zeichenfolge „#EXCLUDE“ anhängen, dann werden diese Objekte nicht ausgewählt. „#EXCLUDE“ hat ein höheres Gewicht als die Auswahl eines Objekts.
Wenn Sie weder den Parameter -o noch -p verwenden, dann werden alle Business Objects importiert. |
| [-ignoreVersion] | Normalerweise muss das Business Object in der Quell- und Zieldatenbank die gleiche Version haben. Falls die Versionen abweichen, lässt sich das Business Object nicht importieren.
Mit dem Parameter –ignoreVersion können Sie den Versionsvergleich ignorieren. Die Prüfung, ob der Spaltenvorrat beim Export und Import identisch ist, wird mit diesem Parameter nicht abgeschaltet. In der Regel kombinieren Sie diesen Parameter mit dem Parameter –force. Hinweis: Beachten Sie, dass das Ignorieren des Versionsvergleichs zu inkonsistenten Daten führen kann. |
| [-force] | Normalerweise müssen die Spalten eines Business Objects in der Quell- und Zieldatenbank identisch sein. Falls Spalten in einer der Datenbanken wechselseitig nicht existieren, dann bricht der Import ab.
Mit dem Parameter –force können Sie die Prüfung der Spalten abschalten. In der Regel kombinieren Sie diesen Parameter mit dem Parameter ‑ignoreVersion. Hinweis: Beachten Sie, dass das Abschalten der Spaltenprüfung zu inkonsistenten Daten führen kann. |
| [-overwrite] | Normalerweise wird beim Import geprüft, ob die Zieldatenbank leer ist.
Mit dem Parameter –overwrite können Sie die Prüfung abschalten. Der Import löscht den vorherigen Inhalt der Zieldatenbank und fügt die zu importierenden Daten ein. |
| [-verbose] | Parameter für zusätzliche Ausgaben in der Toolshell während des Imports. |
| [-threads] | Angabe der Anzahl der Threads, die parallel die Daten importieren. Wenn das System leistungsfähig ist, dann können Sie die Anzahl der Threads erhöhen.
Der Vorschlagswert ist 3. |