XML-Datenimport mit KeepTool und Oracle XML DB

Aktualisiert Oktober 2025

---

Einführung

In einer neuen zweiteiligen Blogserie zeigen wir Ihnen, wie Sie KeepTool in Verbindung mit Oracle XML DB nutzen können. Wie Sie sich vielleicht erinnern, ermöglicht Oracles Standard-XML-Lösung das Speichern und Abrufen von XML-Dokumenten direkt in der Datenbank. Sie können XML-Schemata registrieren und Abfragen über objekt-relational strukturierte Daten ausführen. Dieser erste Blogeintrag führt Sie in die Grundlagen ein und gipfelt in einer funktionierenden Datenimport-Schnittstelle für die Tabelle HR.EMPLOYEES.

Im nächsten Blog zeigen wir, wie Sie eine Datenexport-Schnittstelle erstellen. Sie lernen, wie man technisch mit Master/Detail-Beziehungen (z. B. HR.DEPARTMENTS und HR.LOCATIONS) umgeht.
Insgesamt konzentrieren wir uns strikt auf die wesentlichen Schritte — Sie haben später noch viel Raum, die Logik an Ihre eigenen Anforderungen anzupassen.

---

Ein typischer Anwendungsfall

Stellen Sie sich eine regionale Niederlassung eines großen Unternehmens vor. Lokal wird eine eigene Kopie der HR-Datenbank geführt. Die Mitarbeiterdaten werden zentral in der Zentrale verwaltet. Die regionale Stelle erhält Updates zu neuen oder geänderten Mitarbeiterdaten per XML-Schnittstelle:

• Die Hauptdatenbank sendet periodisch (z. B. nachts oder bei jeder Änderung eines Datensatzes) neue oder modifizierte EMPLOYEES-Daten als XML.
  Diese XML-Struktur kann über Web-Services, Remote-Datenbankzugriffe oder andere Mechanismen übertragen werden.

• Die lokale Seite empfängt die XML-Datenstruktur und importiert sie in die eigene Datenbank.
  Neue Datensätze werden eingefügt, bestehende Datensätze aktualisiert.

In Teil 1 unserer Serie zeigen wir, wie eine XML-Struktur importiert werden kann. Die EMPLOYEES-Daten der lokalen HR-Datenbank werden entweder eingefügt oder aktualisiert. Der zweite Blogbeitrag erläutert anschließend, wie der Datenexport technisch umgesetzt wird.

---

Definition von PL/SQL-Types

Wir orientieren uns an der HR.EMPLOYEES-Tabelle und definieren zuerst PL/SQL-Typen, die Oracle XML DB die Erstellung eines XSD-Schemas ermöglichen:

• EMPLOYEE_XML_ITEM: ein Objekttyp, dessen Attribute den Spalten der Tabelle entsprechen

• EMPLOYEES_XML_LIST: ein Collection-Typ, der eine Liste von EMPLOYEE_XML_ITEM darstellt

• EMPLOYEES_XML_ELEM: ein Objekttyp, der eine Instanz von EMPLOYEES_XML_LIST enthält
  (Wir benötigen diese Verschachtelung, um die Collection in ein Wurzel-Element zu kapseln.)

Auf Horas SQL-Seite führen Sie den folgenden Code aus, um diese PL/SQL-Typen zu erzeugen:

Anschließend finden Sie die Typen in Hora unter PL/SQL Types („All types“ Tab). Dort werden Objekttypen und Collection-Typen gemeinsam aufgelistet:

Hora zeigt automatisch Warnungen und Fehlermeldungen des Datenbankservers an.

---

Erzeugen des XSD-Schemas

Nun verwenden wir dbms_xmlschema.generateschema, um eine XML-Schemabeschreibung zu erzeugen:

select dbms_xmlschema.generateschema( 'HR', 'EMPLOYEES_XML_ELEM', 'EMPLOYEES_LIST') from dual;

Das Ergebnis ist ein CLOB mit dem XSD, den wir anschließend mit dbms_xmlschema.registerschema registrieren:

begin
  dbms_xmlschema.registerschema( 'EMPLOYEES.XSD',
    dbms_xmlschema.generateschema(
      schemaname => 'HR',
      typename => 'EMPLOYEES_XML_ELEM',
      elementname => 'EMPLOYEES_LIST'),
    gentypes => FALSE,
    genbean => FALSE,
    gentables => FALSE);
end;

Nachdem Sie diesen anonymen Block ausgeführt haben, ist das XSD in der Datenbank registriert. In Hora sehen Sie dann auf der XML-Seite:

• Die Auflistung des XSDs

• Eine Mapping-Ansicht zwischen XSD-Elementen und PL/SQL-Typen

Zur Vereinfachung haben wir die beschriebenen PL/SQL-Logiken in einem Paket XML_LOGIC gebündelt:

Mit diesem Package reicht später ein einfacher Aufruf:

begin
  XML_LOGIC.register_xsd( 'EMPLOYEES');
end;

Zusätzlich zur Registrierung in der Datenbank wird die XSD als Datei in einem vordefinierten Oracle-Verzeichnis gespeichert — ideal, um sie an Entwicklerteams weiterzugeben, die XML-Daten importieren wollen.

---

Schnittstellentabelle für den Datenimport

Zur Verwaltung des XML-Importprozesses definieren wir eine Schnittstellentabelle namens XML_EMPLOYEES_TRANSFER. Externe Systeme fügen ihre XML-Payloads in diese Tabelle ein:

Wichtige Spalten:

• ID: Primärschlüssel, gesetzt durch einen Trigger, basierend auf einer Sequenz

• XML_DATA: CLOB mit dem XML-Dokument

• Metadata-Spalten: Zeitstempel, Statistikwerte, Fehlerprotokoll

Auf dieser Basis wird eine relationale Sicht erstellt: XML_EMPLOYEES_TRANS_DATA_V, die XML-Daten und Metadaten gemeinsam darstellt:

Diese View verwendet Oracle-Techniken (z. B. XMLTable), um XML-Inhalte in tabellarische Spalten zu zerlegen. Weitere Informationen zur Technik finden Sie z. B. hier:  https://www.oratable.com/xmltable-convert-xml-to-relational-form/ .

---

Logik für den Datenimport

Nun erstellen wir das Paket XML_INTERFACE, das eine Prozedur für den XML-Import enthält. Die Implementierung umfasst folgende Schritte:

1. Iteration über Datensätze in XML_EMPLOYEES_TRANS_DATA_V für eine gegebene Import-ID

2. Für jeden Datensatz:

   • Wenn EMPLOYEE_ID bereits existiert:

     • Wenn der Datensatz gesperrt ist, überspringen

     • Andernfalls: Update

   • Falls nicht vorhanden: Insert

3. Nach der Verarbeitung: Statistik aktualisieren und Fehlerprotokoll führen

….

Der Import erfolgt in zwei Schritten:

• Einfügen des XML-Dokuments in XML_EMPLOYEES_TRANSFER

• Aufruf von XML_INTERFACE.ProcessEmployeesImport(transfer_id)

---

Darstellung importierter Daten

Nach dem Import können Sie die Ergebnisse direkt in Hora einsehen:

Nach Ausführung der Prozedur zeigt die Datenansicht in Hora den eingefügten Datensatz an:

Die Zeitstempel der Transfer-Tabelle wurden ebenfalls aktualisiert:

Die View XML_EMPLOYEES_TRANS_DATA_V ermöglicht es, XML-Inhalt zusammen mit den Spalten der XML_EMPLOYEES_TRANSFER Tabelle in relationaler Form anzuzeigen:

---

Fazit

Ihre XML-basierte Import-Schnittstelle funktioniert nun! Sie können unser Beispiel als Vorlage herunterladen und für eigene Projekte anpassen.
Bereits in zahlreichen Projekten wurde dieser Ansatz erfolgreich eingesetzt — Entwickler berichten von deutlich gesteigerter Produktivität durch die Verwendung unserer Tools.

Im nächsten Blogbeitrag bauen wir die Export-Schnittstelle, inklusive Master/Detail-Beziehungen, auf.

---