Nicht angemeldet

ibk

Export und Import

Um die Datenbank zu sichern oder sie auf einen anderen Server zu übertragen können Sie grundsätzlich die Werkzeuge Ihrer Datenbank verwenden wie z.B. Oracle «Data Pump» oder PostgreSQL «pg_dump». Es gibt wenig das gegen die Verwendung dieser Werkzeuge spricht und tatsächlich sind sie die erste Wahl für viele Aufgaben da sie schnell sind.

Ab BPS 2.24 stehen zudem Scripts dafür zur Verfügung welche den Export/Import eines BPS Schemas erheblich vereinfachen. Ausserdem ist es damit problemlos möglich auf einen anderen Schemanamen zu importieren, Tablespacekonfiguration zu ändern und sogar einen Reorg durchzuführen. Details dazu finden sich im Developer WIKI sowohl für Oracle als auch für PostgreSQL. Was bei älteren BPS Versionen zu beachten ist wo diese Scripts noch nicht zur Verfügung stehen lesen Sie weiter unten.

Es gibt aber gewisse Einschränkungen bei Verwendung der datenbankeigenen Werkzeuge:

  • Sie sind nicht unabhängig von der Datenbank, sodass es nicht möglich ist einen Oracle Export in PostgreSQL zu importieren oder umgekehrt.

  • Manchmal ist es nicht mal möglich den Export einer neueren Version auf einer älteren Version wieder zu importieren. Ein Export von Oracle 19 scheitert z.B. beim Import auf Oracle 18ex obwohl die Zielversion beim Export explizit definiert wird. Glücklicherweise ist es der umgekehrte Weg problemlos.

  • Sie erlauben keine Filterung von Daten wie zum Beispiel archivierte Datensätze oder Zeilen welche zur Löschung markiert sind, das führt unter Umständen zu langen Laufzeiten wenn Daten von einer Produktionsdatenbank in eine Test- oder Qualitätsdatenbank übertragen werden sollen und die archivierten Daten oder die Auditdaten nicht benötigt werden.

  • Die Migration eines Schemas auf einen anderen Schemanamen ist aufwändiger als mit den BPS eigenen Tools. Berechtigungen müssen mit separaten Skripten oder manuell neu vergeben verden. Für die einwandfreie Migration mit DB Werkzeugen müssen Sie genau verstehen wie die BPS Datenbank organisiert ist.

BPS hat deshalb auch Export- und Import-Skripts welche die Daten in einem datenbankunabhängigen XML Format speichern. Die Laufzeit dieser Scripts ist erheblich länger, aber manchmal ist das die einizige Option.

Export Skript

Das Skript exportiert standardmässig alle vitalen Daten, lässt aber alle nicht vitalen Daten wie Anmeldungen, Sperren und Auditierungsdaten weg.

Das Exportskript wird von der Kommandozeile mit Hilfe des BPS Skript Interpreters gestartet. Wenden Sie den Schalter -h an um die Beschreibung des Aufrufs und der möglichen Optionen der aktuellen Version des Skripts zu erhalten:

C:\Program Files\IBK BPS 2.22.1\bin> bps export -h
SYNOPSYS

    bps export CONNECTSTRING [FILENAME] [OPTION]...

BESCHREIBUNG

    Diese Anwendung exportiert die BPS Datenbank in eine XML Datei.

    Als Vorgabe werden alle standard BPS Sequenzen und Tabellen mit Nutzdaten
    einbezogen, und Audittabellen wie auch Tabellen für vorübergehende Daten
    vom Export ausgeschlossen.

    Kundenspezifische Tabellen und Sequenzen können durch die Optionen -i, -I
    im Export einbezogen, nicht erwünschte mit den Optionen -e und -E
    ausgeschlossen werden.

    HINWEISE

     - Geben Sie als CONNECTSTRING die Anmeldung des BPS Besitzers als
       BenutzerID/PIN@Verbindung an.
     - Wenn FILENAME weggelassen wird. wird bps--.bpx
       verwendet.
     - Wenn der angegebene Dateiname keine Erweiterung hat, wird .bpx verwendet.

    BEISPIELE

    Basisexport der BPS Nutzdaten und Sequenzen in den Vorgabe-Dateinamen:
       bps export 0/1234@plant

    Basisexport der BPS Nutzdaten nach c:\test\myfile.xml:
       bps export 0/1234@plant c:\test\myfile.xml
  
    Inkludiere alle kundenspezifische Tabellen ct_* ausser ct_temp
    und ct_scratch:
        bps export 0/1234@plant -i ct!_% -e ct!_temp,ct!_scratch
  
OPTIONEN

    -n, --nodefaulttables
        Vorgabetabellen nicht inkludieren, nur die durch -i und -e definierten.
  
    -N, --nodefaultsequences
        Vorgabesequenzen nicht inkludieren, nur die durch -I und -E
        definierten.
  
    -d, --nodeleted
        Datensätze mit Löschstatus in regulären BPS Tabellen ausschliessen.
  
    -a, --noarchived
        Datensätze mit Archivstatus in regulären BPS Tabellen ausschliessen.
  
    -h, --help
        Hilfe anzeigen (diese).
  
    -i INCLUDETABLES, --includetables=INCLUDETABLES
      Eine kommaseparierte Liste von inkludierten Tabellenmustern.
  
      - Die Muster müssen in Kleinbuchstaben sein und werden für SQL LIKE
        Vergleiche verwendet, wobei ! als Escapezeichen verwendet wird.

    -e EXCLUDETABLES, --excludetables=EXCLUDETABLES
        Eine kommaseparierte Liste von exkludierten Tabellenmustern.
  
        - Die Muster müssen in Kleinbuchstaben sein und werden für SQL LIKE
          Vergleiche verwendet, wobei ! als Escapezeichen verwendet wird.
  
        - Tabellen welche von anderen inkludierten Tabellen referenziert sind
          werden trotzden inkludiert.
    
    -I INCLUDESEQUENCES, --includesequences=INCLUDESEQUENCES
      Eine kommaseparierte Liste von inkludierten Sequenzenmustern.
  
       - Die Muster müssen in Kleinbuchstaben sein und werden für SQL LIKE
          Vergleiche verwendet, wobei ! als Escapezeichen verwendet wird.
  
    -E EXCLUDESEQUENCES, --excludesequences=EXCLUDESEQUENCES
        Eine kommaseparierte Liste von exkludierten Sequenzenmustern.
   
        - Die Muster müssen in Kleinbuchstaben sein und werden für SQL LIKE
          Vergleiche verwendet, wobei ! als Escapezeichen verwendet wird.
  
Benötigte Zeit war 0 Stunde(n), 0 Minute(n) und 1 Sekunde(n).
  
C:\Program Files\IBK BPS 2.22.1\bin>

Import Skript

Das Skript importiert standardmässig alle Tabellendaten und Sequenzen welche sich in der Exportdatei befinden. Auf der Ziel-Datenbank müssen vorgängig die BPS Objekte mit der gleichen BPS Version erzeugt werden von welcher der Export stammt, siehe Einrichten der Datenbank.

Alle Tabellen werden in der Ziel-Datenbank per Truncate gelöscht bevor der Import der neuen neuen Daten beginnt damit durch die neuen Daten keine Regeln (Constraints) verletzt werden.

Es gibt Optionen um Tabellen, archivierte Daten oder Daten die zur Löschung vorgesehen sind zu exkludieren.

Das Importskript wird von der Kommandozeile mit Hilfe des BPS Skript Interpreters gestartet. Wenden Sie den Schalter -h an um die Beschreibung des Aufrufs und der möglichen Optionen der aktuellen Version des Skripts zu erhalten:

C:\Program Files\IBK BPS 2.22.1\bin> bps import -h
SYNOPSYS

    bps import CONNECTSTRING FILENAME [OPTION]...

BESCHREIBUNG

    Diese Anwendung importiert die BPS Datenbank von einer BPS Exportdatei
    (bpx).

    Standardmässig werden alle Tabellen und Sequenzen der Exportdatei
    importiert.

    Tabellen können mit der Option -e ausgeschlossen werden.
    Sequenzen können mit der Option -E ausgeschlossen werden.
    Datensätze können mit den Schaltern -h und -d gefiltert werden.

    HINWEISE

     -  Geben Sie als CONNECTSTRING die Anmeldung des BPS Besitzers als
       BenutzerID/PIN@Verbindung an.
     - Wenn der angegebene Dateiname keine Erweiterung hat, wird .bpx verwendet.
  
    BEISPIELE

    Basisimport der ganzen Exportdatei bps-plant-20100108135920.bpx:
      bps import 0/1234@plant bps-plant-20100108135920

    Archivierte und zu löschende Datensätze ausschliessen:
      bps import 0/1234@plant mydump.bpx -h -d

    Kundenspezifische Tabellen mit Namensmuster ct_* ausschliessen:
      bps import 0/1234@plant mydump.bpx -e ct!_%

OPTIONEN

    -d, --nodeleted
        Datensätze die zum Löschen markiert sind ausschliesssen.
        Es ist wahrscheinlich dass dieser Schalter Constraintfehler bei
        abhängigen Datensätzen verursacht, deshalb wird der Import nach solchen
        Fehlern fortgesetzt.

    -a, --noarchived
        Datensätze die archiviert sind ausschliesssen.
        Es ist wahrscheinlich dass dieser Schalter Constraintfehler bei
        abhängigen Datensätzen verursacht, deshalb wird der Import nach solchen
        Fehlern fortgesetzt.

    -h, --help
        Hilfe anzeigen (diese).

    -e EXCLUDETABLES, --excludetables=EXCLUDETABLES
        Eine kommaseparierte Liste von exkludierten Tabellenmustern.

        - Die Muster müssen in Kleinbuchstaben sein und werden für SQL LIKE
          Vergleiche verwendet, wobei ! als Escapezeichen verwendet wird.

    -E EXCLUDESEQUENCES, --excludesequences=EXCLUDESEQUENCES
        Eine kommaseparierte Liste von exkludierten Sequenzmustern.

        - Die Muster müssen in Kleinbuchstaben sein und werden für SQL LIKE
          Vergleiche verwendet, wobei ! als Escapezeichen verwendet wird.

Benötigte Zeit war 0 Stunden, 0 Minuten und 1 Sekunden.

C:\Program Files\IBK BPS 2.22.1\bin>

Manueller Export/Import mit Datenbankwerkzeugen

Bei Verwendung der Datenbank Werkzeuge (z.B. Oracle «Data Pump» oder PostgreSQL «pg_dumpall») müssen gewisse Funktionen separat abgehandelt werden welche bei den BPS Skripts automatisch erledigt werden.

Ab Version 2.24 stehen die Scripts bpsoraexp, bpsoraimp, bpspgexp und bpspgimp zur Verfügung welche wir in der Entwicklung benützen um BPS Schemata per Oracle Data Pump zu exportieren und importieren. Alle nachfolgend beschriebenen Schritte sind in diesen Scripts automatisiert. Details zu diesen Scripts finden Sie im Developer WIKI.

  • Die Audit-Tabellen müssen eventuell vorgängig bereinigt werden damit die Datenmenge eingeschränkt wird (Siehe Auditierung), oder die Audit-Tabellen (alle die mit ta_ beginnen) müssen komplett aus dem Export ausgenommen werden.
     
  • Tabellen mit transienten Daten (z.B. Sperrtabellen und Tabellen mit Informationen zu aktuellen Anmeldungen) müssen entweder bereits vorgängig aus dem Export ausgenommen werden, oder nachträglich geleert werden (z.B. per Truncate). Die zur aktuellen BPS Version gehörige Liste der betreffenden Tabellen finden Sie am Anfang des BPS Skripts export.js in der Liste mExcludes. Diese Liste kann bei neuen BPS Versionen jeweils erweitert werden.
     
  • Falls die verwendeten Tablespaces zwischen der Export und Import Datenbank unterschiedlich heissen, müssen diese nach dem Import in den BPS Einstellungen unter Central System Settings / Install korrigiert werden.
     
  • Wenn der Schemaname zwischen Quell- und Ziel-Datenbank unterschiedlich ist, müssen sämtliche Berechtigungen (Grants) auf die entsprechenden Rollen korrigiert werden. Ebenfalls müssen alle übrigen Regeln (Constraints) kontrolliert und ggf. korrigiert werden falls diese das alte Schema referenzieren.

    Für die meisten ist das folgende Verfahren einfacher und sicherer wenn das Schema unterschiedlich ist:
     
    • Erstellen Sie zunächst mit dem Assistent für neue Datenbanken das neue Schema auf der Zieldatenbank. Verwenden Sie dazu dieselbe BPS Version wie bei der Quelldatenbank.
       
    • Leeren Sie die neuen Tabellen z.B. per Truncate (die meisten sollten bereits leer sein)
       
    • Importieren Sie mit den DB Werkzeugen ausschliesslich die Daten, bei Oracle Datapump z.B. mit CONTENT=DATA_ONLY
  • Die Schattensummen können inkonsistent sein falls die Datenbank während des Exports in Gebrauch war. Aktualisieren sie die Schattensummen deshalb mittels der Datenbank-Prozeduren p_rebuildstockshadow , p_rebuildordershadow und p_rebuildpackshadow nach dem Import und während noch niemand anders die Datenbank verwendet.
Kommentare