Komplexe XML-Dokumente über XSU und Objekt-Typen aus der Datenbank generieren

Transkript

1 Komplexe XML-Dokumente über XSU und Objekt-Typen aus der Datenbank generieren Autor: Norbert Bahn, Opitz Consulting DOAGNews Q3_2005 Dieses Werk ist urheberrechtlich geschützt. Die dadurch begründeten Rechte, insbesondere die der Übersetzung, des Nachdrucks, des Vortrags, der Entnahme von Abbildungen und Tabellen, der Funksendung, der Mikroverfilmung oder der Vervielfältigung auf anderen Wegen und der Speicherung in Datenverarbeitungsanlagen, bleiben, bei auch nur auszugsweiser Verwertung, vorbehalten. Eine Vervielfältigung dieses Werkes oder von Teilen dieses Werkes ist auch im Einzelfall nur in den Grenzen der gesetzlichen Bestimmungen des Urheberrechtes der Bundesrepublik Deutschland vom 9. September 1965 in der jeweils geltenden Fassung zulässig. Sie ist grundsätzlich vergütungspflichtig. Zuwiderhandlungen unterliegen den Strafbestimmungen des Urheberrechtsgesetzes.

2 Das XML-SQL-Utility (XSU) unterstützt seit Oracle 9i die Erstellung von XML-Dokumenten aus Datenbank-Content. Bereitgestellt wird diese Funktionalität über eine Java- bzw. PL/SQL- Schnittstelle. In diesem Artikel wird der Fokus auf die PL/SQL-Schnittstelle gelegt. Sie wird über das Package DBMS_XMLQuery bereitgestellt und ist über Wrapper realisiert, welche die XDK- Java-Klassen referenzieren, die bei einer Standard-Installation bereits in der Datenbank angelegt wurden. In seiner kanonischen Form kann die Erzeugung einer XML-Datei mit folgendem Dreizeiler erfolgen: declare queryctx DBMS_XMLquery.ctxType; result CLOB; begin queryctx := DBMS_XMLQuery.newContext('select * from emp'); DBMS_XMLQuery.closeContext(queryCtx); end; Die Variable result beinhaltet nach der Ausführung der Funktion getxml folgenden Content: <?xml version = '1.0'?> <ROWSET> <ROW num="1"> <EMPNO>7839</EMPNO> <ENAME>KING</ENAME> <JOB>PRESIDENT</JOB> <HIREDATE>11/17/1981 0:0:0</HIREDATE> <SAL>5000</SAL> <DEPTNO>10</DEPTNO> </ROW> <ROW num="2"> <EMPNO>7698</EMPNO> <ENAME>BLAKE</ENAME> Der Root-Tag trägt standardmäßig den Namen <ROWSET> und jeder Datensatz der definierten Abfrage wird durch den Tag <ROW> gekapselt. Die Inhalte der einzelnen Spalten werden in Tags präsentiert, die dem Spaltennamen entsprechen.

3 Nun können durch weitere Funktionen und Prozeduren aus dem Package DBMS_XML-Query die Namen der Tags <ROWSET> und <ROW> modifizert, Stylesheet-Trans-formation ausgeführt oder weitere Parameter gesetzt werden. Generiert wird aber immer ein flaches, 2-stufiges XML-Dokument mit der Struktur Datensatzgruppe, Datensatz. <Rowset>- und <Row>-Tagname werden folgendermaßen angepasst: DBMS_XMLQuery.setRowsetTag(queryCtx, 'EmpInDept'); DBMS_XMLQuery.setRowTag(queryCtx, 'Department'); Möchte man z.b. alle Abteilungen und die in den Abteilungen arbeitenden Mitarbeiter in einem XML-Dokument hierarchisch darstellen, so wird man bei Verwendung der relationalen Brille einen Join über EMP und DEPT umformulieren. In diesem Fall aber tritt ein unerwünschter Effekt auf: Die Department-Daten werden im XML-Dokument redundant abgelegt. queryctx := DBMS_XMLQuery.newContext ('SELECT dname, loc, empno, ename, hiredate, job, sal ' 'FROM emp JOIN dept USING(deptno)'); <?xml version = '1.0'?> <ROWSET> <ROW num="1"> <DNAME>ACCOUNTING</DNAME> <LOC>NEW YORK</LOC> <EMPNO>7839</EMPNO> <ENAME>KING</ENAME> <HIREDATE>11/17/1981 0:0:0</HIREDATE> <JOB>PRESIDENT</JOB> <SAL>5000</SAL> </ROW> <ROW num="2"> <DNAME>ACCOUNTING</DNAME> <LOC>NEW YORK</LOC> Die Abteilungsdaten werden je Mitarbeiter wiederholt aufgeführt. Dies ist in vielen Fällen unschön und speicheraufwändig. Sinnvoller wäre es, ein mehrstufiges hierarchisches

4 XML-Dokument zu erzeugen, welches einmal die Daten der Abteilung und eine Hierarchiestufe darunter die Daten der Mitarbeiter darstellt. Dieses nicht ganz triviale Ziel kann über die Verwendung der objektrelationalen Features von Oracle erreicht werden. Grundsätzlich wird ein mehrstufiges hierarchisches XML-Dokument erstellt, wenn Spalten der Ausgangstabelle bzw. des Ausgangsviews auf dem Datentyp einer Nested-Table basieren. Nun ist es im operativen Geschäft nicht immer angebracht, diesen Datentyp zu verwenden, in unserem Beispiel möchten wir auch darauf verzichten. Stattdessen verwenden wir eine Funktion, welche aus den Daten der Tabelle Emp ein Nested-Table- Objekt zusammenbaut und zurückliefert. Die zu verwendenden Objekte werden nun der Reihe nach vorgestellt. 1. Objekt-Typ anlegen: create or replace type emp_obj as object ( empno number(4), ename varchar2(10), hiredate date, job varchar2(9), sal number(7,2) ); 2. Nested-Table-Collection of Objekt-Typ anlegen: create or replace type emp_liste is table of emp_obj; 3. Funktion anlegen, die alle Mitarbeiter-Daten einer übergebenen Abteilungsnummer in einer Nested-Table-Collection zurückliefert: CREATE OR REPLACE FUNCTION emp_details(dnr number) RETURN emp_liste IS emp_l emp_liste; BEGIN SELECT emp_obj(empno, ename, hiredate, job, sal) emp_obj BULK COLLECT INTO emp_l FROM emp WHERE deptno = dnr; RETURN emp_l; END;

5 4. XML-Generierung starten: DECLARE queryctx DBMS_XMLquery.ctxType; result CLOB; BEGIN queryctx := DBMS_XMLQuery.newContext('SELECT deptno, loc,' 'emp_details(deptno) employees FROM dept'); DBMS_XMLQuery.setRowsetTag(queryCtx, 'EmpInDept'); DBMS_XMLQuery.setRowTag(queryCtx, 'DEPARTMENT'); DBMS_XMLQuery.closeContext(queryCtx); END; 5. Ergebnis: <?xml version = '1.0'?> <EmpInDept> <DEPARTMENT num="1"> <DEPTNO>10</DEPTNO> <LOC>NEW YORK</LOC> <EMPLOYEES> <EMPLOYEES_ITEM> <EMPNO>7839</EMPNO> <ENAME>KING</ENAME> <HIREDATE>11/17/1981 0:0:0</HIREDATE> <JOB>PRESIDENT</JOB> <SAL>5000</SAL> </EMPLOYEES_ITEM> <EMPLOYEES_ITEM> <EMPNO>7782</EMPNO> Die im Schritt 3 erstellte Funktion hatte die Aufgabe, die Mitarbeiter einer Abteilung in Form einer Collection bereit zu stellen. Auf diese Funktion könnte aber verzichtet werden, wenn die unter Oracle 9i eingeführten Collection-Operatoren Cast und Multiset verwendet werden. Sie liefern die Ergebnismenge des geschalteten Select-Statements als Collection zurück, die dann nur noch in den richtigen Collection-Typ gecastet werden muss.

6 DECLARE queryctx DBMS_XMLquery.ctxType; result CLOB; BEGIN queryctx := DBMS_XMLQuery.newContext( 'Select deptno, loc, CAST(MULTISET(select empno, ename, hiredate, job, sal from emp e where e.deptno = d.deptno) AS emp_liste) AS employees From dept d'); DBMS_XMLQuery.setRowsetTag(queryCtx, 'EmpInDept'); DBMS_XMLQuery.setRowTag(queryCtx, 'DEPARTMENT'); printclob(result); DBMS_XMLQuery.closeContext(queryCtx); END; Unschön am Ergebnis, egal mit welcher Variante, ist die geschachtelte Tag-Kombination von <EMPLOYEES> und <EMPLOYEES_ITEM>. Diese ergibt sich aus dem Objekt-Typ und ist auch nicht zu konfigurieren. Über eine Stylesheet-Transformation könnte diese Tag-Kombination durch den einfachen Tag <EMPLOYEE> ersetzt werden. Kontakt: Norbert Bahn norbert.bahn@opitz-consulting.de