How To: Oracle XML DB

Transkript

1 How To: Oracle XML DB Warnecke, Annegret Oracle Deutschland GmbH, Berlin - Listings - Überblick über die Scripte: zu: Oracle XML DB Basics - XMLType in Oracle Tabellen - 1. Einrichten einer Tabelle mit XMLType Spalte sowie Input in die Tabelle 2. Eingabe eines durch eine DTD definiertes XML Dokument; Eingabe wird abgewiesen, wenn Dokument nicht der DTD entspricht 3. Update eines gesamten XML Dokumentes bzw. gezielter Update einer Teilinformation eines bestimmten Dokumentes 4. Erweiterung einer bestehenden Tabelle um eine weitere Spalte 5. Beispiel für die Arbeitsweise von XMLType Tabellen (ohne Schemavalidierung) 6. Erzeugung von relationalen Stukturen aus XML Dokumenten 7. Beispiele für die Erstellung von XML Dokumenten (Tabellen oder Views) aus relationalen Tabellen zu: XML Schema und Oracle XML DB Repository 8. Repository Grundlagen - Einrichten eines Folders und Laden eines XML Dokumentes 9. Repository Grundlagen - verschiedene Sichten mit dem Resource_View auf das Repository sowie Löschen des Dokumentes "presentation.xml" 10. Anmeldung eines XML Schemas am Repository und Schemaprüfung 11. Generierung einer XMLType Tabelle mit Referenz zu einem XML Schema zu: XML Dokumente mit XSLT umwandeln und im Browser darstellen 12. Stylesheet presentation.xsl sowie URLs für die Darstellung im Browser 1. Einrichten einer Tabelle mit XMLType Spalte sowie Input in dietabelle (Basisformatierungen in SQL/Plus setzen) set long set linesize 100; set pagesize 1000; column Adresse format A70; Tabelle erstellen und mit Inhalt füllen drop table Adr_List; 1

2 create table Adr_List ( lfd_nr number (10), Adresse xmltype ); Tabelle wurde angelegt values(10,xmltype('<adr><name>karin</name><ort>hamburg</ort></adr>')); values(20,xmltype('<adr><name>theo</name><ort>hamburg</ort></adr>')); values(30,xmltype('<adr><name>peter</name><ort>hamburg</ort></adr>')); values(10,xmltype('<adr><name>peter</name><ort>bremen</ort></adr>')); values(50,xmltype('<adr><name>petra</name><ort>bremen</ort></adr>')); values(60,xmltype('<adr><name>theo</name><ort>bremen</ort></adr>')); values(70,xmltype('<adr><name>karin</name><ort>hannover</ort></adr>')); commit; Transaktion mit COMMIT abgeschlossen. Beispiel für ein nicht wohlgeformtes Dokument values(70,xmltype('<adr><name>karin</name><ort>hannover</ort></adr>')); values(70,xmltype('<adr><name>karin</name><ort>hannover</ort></adr>')) * FEHLER in Zeile 1: ORA-31011: XML-Parsing nicht erfolgreich ORA-19202: Fehler bei XML-Verarbeitung LPX-00225: end-element tag "Adr" does not match start-element tag "adr" Error at line 1 aufgetreten ORA-06512: in "SYS.XMLTYPE", Zeile 0 ORA-06512: in Zeile 1 Inhalt der Tabelle anzeigen lassen select a.lfd_nr, a. Adresse.getClobVal() from Adr_List a; select * from Adr_List; LFD_NR ADRESSE 2

3 <Adr><Name>Karin</Name><Ort>Hamburg</Ort></Adr> 20 <Adr><Name>Theo</Name><Ort>Hamburg</Ort></Adr> 30 <Adr><Name>Peter</Name><Ort>Hamburg</Ort></Adr> 10 <Adr><Name>Peter</Name><Ort>Bremen</Ort></Adr> 50 <Adr><Name>Petra</Name><Ort>Bremen</Ort></Adr> 60 <Adr><Name>Theo</Name><Ort>Bremen</Ort></Adr> 70 <Adr><Name>Karin</Name><Ort>Hannover</Ort></Adr> 7 Zeilen ausgewählt. 2. Eingabe eines durch eine DTD definiertes XML Dokument; Eingabe wird abgewiesen, wenn Dokument nicht der DTD entspricht Eingabe eines gültigen XML Dokumentes values(80, xmltype(' <!DOCTYPE Adr [ <!ELEMENT Adr (Name, Ort)> <!ELEMENT Name (#PCDATA)> <!ELEMENT Ort (#PCDATA)> ]> <Adr><Name>Uwe</Name><Ort>Hannover</Ort></Adr>')); 1 Zeile wurde erstellt. select a.adresse.getclobval() from Adr_List a where lfd_nr=80; ADRESSE <!DOCTYPE Adr [ <!ELEMENT Adr (Name, Ort)> <!ELEMENT Name (#PCDATA)> <!ELEMENT Ort (#PCDATA)> ]> <Adr><Name>Uwe</Name><Ort>Hannover</Ort></Adr> Eingabe eines nicht gültigen XML Dokumentes values(80, xmltype(' <!DOCTYPE Adr [ <!ELEMENT Adr (Name, Ort)> <!ELEMENT Name (#PCDATA)> <!ELEMENT Ort (#PCDATA)> ]> <adr><name>uwe</name><ort>hannover</ort></adr>')); 3

4 xmltype(' <!DOCTYPE Adr [ * FEHLER in Zeile 2: ORA-31011: XML-Parsing nicht erfolgreich ORA-19202: Fehler bei XML-Verarbeitung LPX-00104: Warning: element "adr" is not declared in the DTD Error at line 6 aufgetreten ORA-06512: in "SYS.XMLTYPE", Zeile 0 ORA-06512: in Zeile 1 3. Update eines gesamten XML Dokumentes bzw. gezielter Update einer Teilinformation eines bestimmten Dokumentes ein ganzes XML Dokument verändern select a.lfd_nr, a.adresse.getclobval() as Adresse from Adr_List a where lfd_nr=30; LFD_NR ADRESSE <Adr><Name>Peter</Name><Ort>Hamburg</Ort></Adr> update Adr_List set Adresse = XMLTYPE ('<Adr><Name>Gert</Name><Ort>Frankfurt</Ort></Adr>') where lfd_nr = 30; 1 Zeile wurde aktualisiert. select a.lfd_nr, a.adresse.getclobval() as Adresse from Adr_List a where lfd_nr=30; LFD_NR ADRESSE <Adr><Name>Gert</Name><Ort>Frankfurt</Ort></Adr> Teil eines XML Dokument verändern update Adr_List set Adresse = UPDATEXML (Adresse, '/Adr/Name/text()','Hugo') where lfd_nr = 30; 1 Zeile wurde aktualisiert. 4

5 select a.lfd_nr, a.adresse.getclobval() as Adresse from Adr_List a where lfd_nr=30; ADRESSE <Adr> <Name>Hugo</Name> <Ort>Frankfurt</Ort> </Adr> 4. Erweiterung einer bestehenden Tabelle um eine weitere Spalte weitere Spalte ergänzen und zusätzlichen Datensatz eingeben ALTER TABLE Adr_List add (Hobbies XMLType); Tabelle wurde geändert. desc Adr_List; Name Null? Typ LFD_NR NUMBER(10) ADRESSE XMLTYPE HOBBIES XMLTYPE values(10, xmltype('<adr><name>karin</name><ort>hamburg</ort></adr>'), xmltype('<hobby>lesen, Theater, Tennis</Hobby>')); 1 Zeile wurde erstellt. (Basisformatierungen in SQL/Plus setzen) column Adresse format A40; column Hobbies format A30; select a.lfd_nr, a.adresse.getclobval() as Adresse, a.hobbies.getclobval() as Hobbies from Adr_List a where lfd_nr=10; LFD_NR ADRESSE HOBBIES 5

6 <Adr><Name>Karin</Name><Ort>Hamburg</Ort ></Adr> 10 <Adr><Name>Peter</Name><Ort>Bremen</Ort> </Adr> 10 <Adr><Name>Karin</Name><Ort>Hamburg</Ort></Adr> <Hobby>Lesen, Theater, Tennis< Hobby> Spalte wieder entfernen ALTER TABLE Adr_List drop (Hobbies); Tabelle wurde geändert. select a.lfd_nr, a.adresse.getclobval() as Adresse, a.hobbies.getclobval() as Hobbies from Adr_List a where lfd_nr=10; a.hobbies.getclobval() as Hobbies * FEHLER in Zeile 2: ORA-00904: Ungültiger Spaltenname select a.lfd_nr, a.adresse.getclobval() as Adresse from Adr_List a where lfd_nr=10; LFD_NR ADRESSE <Adr><Name>Karin</Name><Ort>Hamburg</Ort ></Adr> 10 <Adr><Name>Peter</Name><Ort>Bremen</Ort> </Adr> 10 <Adr><Name>Karin</Name><Ort>Hamburg</Ort ></Adr> Beispiel für die Arbeitsweise von XMLType Tabellen (ohne Schemavalidierung) 6

7 XML Type Tabelle erstellen und mit Inhalt füllen drop table Adr; create table Adr of xmltype; Tabelle wurde angelegt. insert into Adr values(xmltype('<adr><name>theo</name><ort>bremen</ort></adr>')); insert into Adr values(xmltype('<adr><name>karin</name><ort>hannover</ort></adr>')); 1 Zeile wurde erstellt. select sys_nc_rowinfo$ as Adressen from Adr; ADRESSEN <Adr><Name>Theo</Name><Ort>Bremen</Ort></Adr> <Adr><Name>Karin</Name><Ort>Hannover</Ort></Adr> 6. Erzeugung von relationalen Stukturen aus XML Dokumenten (Basisformatierungen in SQL/Plus setzen) column Name format A10; column Ort format A10; mit select statements auf Tabelle mit XML Type Informationen zugreifen select lfd_nr, extractvalue(a.adresse,'/adr/name') as Name, extractvalue(a.adresse,'/adr/ort') as Ort from Adr_List a where existsnode(a.adresse, '/Adr[Ort="Bremen"]') = 1; LFD_NR NAME ORT Peter Bremen 50 Petra Bremen 60 Theo Bremen SELECT a.lfd_nr, extract(a.adresse,'/adr/name/text()').getstringval() 7

8 Name FROM Adr_List a; LFD_NR NAME Karin 20 Theo 30 Peter 10 Peter 50 Petra 60 Theo 70 Karin 7 Zeilen ausgewählt. relationalen View auf XML Type Strukturen erzeugen drop view Pers_v; create view Pers_v as select lfd_nr, extractvalue(n.adresse,'/adr/name') as Name from Adr_List n; View wurde angelegt. select * from Pers_v; LFD_NR NAME Karin 20 Theo 30 Peter 10 Peter 50 Petra 60 Theo 70 Karin 9 Zeilen ausgewählt. relationale Tabelle erstellen und mit Inhalt füllen drop table Pers_relational; create table Pers_relational (Name varchar2(20), Ort varchar2(20)); Tabelle wurde angelegt. insert into Pers_relational 8

9 select extractvalue(n.adresse,'/adr/name'), extractvalue(n.adresse,'/adr/ort') from Adr_List n where n.lfd_nr = 10; 3 Zeilen wurden erstellt. select * from Pers_relational; NAME ORT Karin Hamburg Peter Bremen 7. Beispiele für die Erstellung von XML Dokumenten (Tabellen oder Views) aus relationalen Tabellen connect HR/HR Connect durchgeführt. Inhalt der relationalen Tabelle "employees" anzeigen lassen descr employees; Name Null? Typ EMPLOYEE_ID NOT NULL NUMBER(6) FIRST_NAME VARCHAR2(20) LAST_NAME NOT NULL VARCHAR2(25) NOT NULL VARCHAR2(25) PHONE_NUMBER VARCHAR2(20) HIRE_DATE NOT NULL DATE JOB_ID NOT NULL VARCHAR2(10) SALARY NUMBER(8,2) COMMISSION_PCT NUMBER(2,2) MANAGER_ID NUMBER(6) DEPARTMENT_ID NUMBER(4) select e.employee_id, e.first_name, e.last_name, e.hire_date, salary from employees e where employee_id >200; EMPLOYEE_ID FIRST_NAME LAST_NAME HIRE_DAT SALARY 9

10 Michael Hartstein Pat Fay Susan Mavris Hermann Baer Shelley Higgins William Gietz Zeilen ausgewählt. XMLType Tabelle erstellen und mit Inhalt füllen drop table pers_data; create table pers_data of xmltype; Tabelle wurde angelegt. desc pers_data; Name Null? Typ TABLE of XMLTYPE insert into pers_data SELECT XMLELEMENT(Employees, XMLATTRIBUTES ('Verschiedenes...' as Erlaeuterung), XMLAGG(XMLELEMENT(Emp, XMLATTRIBUTES (EMPLOYEE_ID as ID), XMLELEMENT(name, e.first_name ' ' e.last_name), XMLELEMENT ( hiredate, e.hire_date)))) as Personaldaten FROM employees e WHERE employee_id > 204 ; 1 Zeile wurde erstellt. Anzeige des Inhalts der XMLType Tabelle (Nutzung Pseudo Column) select p.sys_nc_rowinfo$.getclobval() as Personaldaten from pers_data p; SYS_NC_ROWINFO$ <EMPLOYEES ERLAEUTERUNG="Verschiedenes..."> <EMP ID="205"><NAME>Shelley Higgins</NAME> <HIREDATE> </HIREDATE> </EMP><EMP ID="206"><NAME>William Gietz</NAME> <HIREDATE> </HIREDATE> </EMP></EMPLOYEES> column Name format A20; Anzeige des Inhalts der XMLType Tabelle (XPath) 10

11 select extractvalue(value(p), as Name from pers_data p; NAME Shelley Higgins Beispiel für Erzeugung XMLType Tabelle drop table pers_data_single; create table pers_data_single of XMLType; Tabelle wurde angelegt. insert into pers_data_single SELECT XMLELEMENT(Emp, XMLATTRIBUTES (EMPLOYEE_ID as ID), XMLELEMENT(name, e.first_name ' ' e.last_name), XMLELEMENT ( hiredate, e.hire_date)) as Personaldaten FROM employees e WHERE employee_id > 200; 6 Zeilen wurden erstellt. select p.sys_nc_rowinfo$.getclobval() as Personaldaten from pers_data_single p; PERSONALDATEN <EMP ID="201"><NAME>Michael Hartstein</NAME><HIREDATE> </HIREDATE></EMP> <EMP ID="202"><NAME>Pat Fay</NAME><HIREDATE> </HIREDATE></EMP> <EMP ID="203"><NAME>Susan Mavris</NAME><HIREDATE> </HIREDATE></EMP> <EMP ID="204"><NAME>Hermann Baer</NAME><HIREDATE> </HIREDATE></EMP> <EMP ID="205"><NAME>Shelley Higgins</NAME><HIREDATE> </HIREDATE></EMP> <EMP ID="206"><NAME>William Gietz</NAME><HIREDATE> </HIREDATE></EMP> 6 Zeilen ausgewählt XMLType View erzeugen auf relationler Tabelle drop view Emp_view; 11

12 CREATE OR REPLACE VIEW Emp_view OF XMLTYPE WITH OBJECT ID AS SELECT XMLELEMENT("Emp", XMLAttributes(empno), XMLForest(e.fname ' ' e.lname AS "name", e.hire AS "hiredate")) AS "result" FROM emps e WHERE salary > 20000; View wurde angelegt. select e.sys_nc_rowinfo$.getclobval() from emp_view e; SYS_NC_ROWINFO$ <Emp EMPNO="2100"><name>John Smith</name><hiredate> </hiredate></Emp> <Emp EMPNO="2200"><name>Mary Martin</name><hiredate> </hiredate></Emp> 8. Repository Grundlagen - Einrichten eines Folders und Laden eines XML Dokumentes connect xdb/xdb; desc resource_view; Name Null? Typ RES SYS.XMLTYPE(XMLSchema "http: //xmlns.oracle.com/xdb/xdbresource.xsd" Element "Resource") ANY_PATH VARCHAR2(4000) neuen Folder im XML DB Repository anlegen DECLARE retbool BOOLEAN; BEGIN retbool:=dbms_xdb.createfolder('/public/doag'); END; / PL/SQL-Prozedur wurde erfolgreich abgeschlossen. commit; 12

13 Transaktion mit COMMIT abgeschlossen. XML Dokument in dem Repository hinterlegen(ohne Schemaprüfung) DECLARE retbool BOOLEAN; BEGIN retbool:=dbms_xdb.createresource('/public/doag/presentation.xml', '<?xml-stylesheet type="text/xsl" href="presentation.xsl"?> <presentation xmlns:xsi=" xsi:nonamespaceschemalocation=" <veranstaltung>doag</veranstaltung> <termin>nov 04</termin> <ort>mannheim</ort> <thema>how To Oracle XML DB</thema> <referent> <name>annegret Warnecke</name> <firma>oracle Deutschland GmbH, Berlin</firma> <funktion>senior Systemberaterin</funktion> </referent> </presentation> '); END; / PL/SQL-Prozedur wurde erfolgreich abgeschlossen. 9. Repository Grundlagen - verschiedene Sichten mit dem Resource_View auf das Repository sowie Löschen des Dokumentes "presentation.xml" set long 10000; Beschreibung des Resource Views für das neu eingestellte Dokument anzeigen lassen select r.res from resource_view r where under_path (r.res, '/public/doag')=1; RES <Resource xmlns=" 13

14 <CreationDate> T07:28: </CreationDate> <ModificationDate> T07:28: </ModificationDate> <DisplayName>presentation.xml</DisplayName> <Language>en-US</Language> <CharacterSet>UTF-8</CharacterSet> <ContentType>text/xml</ContentType> <RefCount>1</RefCount> </Resource> gezielt Informationen aus dem Resource View anzeigen lassen select extractvalue(r.res, 'Resource/DisplayName') as Resourcen from resource_view r where under_path (r.res, '/public/doag')=1; RESOURCEN presentation.xml select r.res.getclobval() as presentation from RESOURCE_VIEW r where ANY_PATH = '/public/doag/presentation.xml'; PRESENTATION <Resource xmlns=" Hidden="false" Inv alid="false" Container="false" CustomRslv="false" VersionHistory="false" StickyR ef="true"> <CreationDate> T02:48: </CreationDate> <ModificationDate> T02:48: </ModificationDate> <DisplayName>presentation.xml</DisplayName> <Language>en-US</Language> <CharacterSet>UTF-8</CharacterSet> <ContentType>text/xml</ContentType> <RefCount>1</RefCount> <ACL> <acl description="public:all privileges to PUBLIC" xmlns=" e.com/xdb/acl.xsd" xmlns:xsi=" xsi:sch emalocation=" http: //xmlns.oracle.com/xdb/acl.xsd"> <ace> <principal>public</principal> <grant>true</grant> <privilege> <all/> </privilege> </ace> 14

15 </acl> </ACL> <Owner>XDB</Owner> <Creator>XDB</Creator> <LastModifier>XDB</LastModifier> <SchemaElement> ent> <Contents> <presentation xmlns:xsi=" xsi:nona mespaceschemalocation=" <veranstaltung>doag</veranstaltung> <termin>10. u. 11. November 04</termin> <ort>mannheim</ort> <thema>how to: Oracle XML DB</thema> <referent> <name>annegret Warnecke</name> <firma>oracle Deutschland GmbH, Berlin</firma> <funktion>senior Systemberaterin</funktion> </referent> </presentation> </Contents> </Resource> Resource löschen call dbms_xdb.deleteresource('/public/doag/presentation.xml'); Aufruf wurde abgeschlossen. commit; Transaktion mit COMMIT abgeschlossen. 10. Anmeldung eines XML Schemas am Repository und Schemaprüfung ein XML Schema Dokument in das Repository stellen DECLARE retbool BOOLEAN; BEGIN retbool:=dbms_xdb.createresource ('/public/doag/presentation.xsd', '<xs:schema xmlns:xs=" xmlns:xdb=" xdb:schemaurl="http: // 15

16 <xs:element name="presentation"> <xs:complextype> <xs:sequence> <xs:element name="veranstaltung"/> <xs:element name="termin"/> <xs:element name="ort"/> <xs:element name="thema"/> <xs:element name="referent"> <xs:complextype> <xs:sequence> <xs:element name="name"/> <xs:element name="firma"/> <xs:element name="funktion"/> </xs:sequence> </xs:complextype> </xs:element> </xs:sequence> </xs:complextype> </xs:element></xs:schema>'); END; / commit; PL/SQL-Prozedur wurde erfolgreich abgeschlossen. das XML Schema am Repository registrieren BEGIN DBMS_XMLSCHEMA.REGISTERSCHEMA(schemaurl=>' /presentation.xsd', schemadoc=>sys.urifactory.geturi('/public/doag/presentation.xsd'), local=>false, gentypes=>true, genbean=>false, gentables=>true, force=>false, owner=>'xdb'); END; PL/SQL-Prozedur wurde erfolgreich abgeschlossen. Input eines gültigen XML Dokumentes mit Bezug auf das registrierte XML Schema insert into "presentation1364_tab" values(xmltype( '<?xml-stylesheet type="text/xsl" href="presentation.xsl"?> <presentation xmlns:xsi=" xsi:nonamespaceschemalocation=" <veranstaltung>doag</veranstaltung> <termin>nov. 04</termin> <ort>mannheim</ort> <thema>how To Oracle XML DB</thema> 16

17 <referent> <name>annegret Warnecke</name> <firma>oracle Deutschland GmbH, Berlin</firma> <funktion>senior Systemberaterin</funktion> </referent> </presentation> ')); 1 Zeile wurde erstellt Input eines nicht gültigen XML Dokumentes mit Bezug auf das registrierte XML Schema insert into "presentation1364_tab" values(xmltype( '<?xml-stylesheet type="text/xsl" href="presentation.xsl"?> <presentation xmlns:xsi=" xsi:nonamespaceschemalocation=" <veranstaltung>doag</veranstaltung> <termin>nov. 04</termin> <Ort>Kiel</Ort> <thema> How To Oracle XML DB</thema> <referent> <name>annegret Warnecke</name> <firma>oracle Deutschland GmbH, Berlin</firma> <funktion>senior Systemberaterin</funktion> </referent> </presentation> ')); insert into "presentation1352_tab" values(xmltype( * FEHLER in Zeile 1: ORA-30937: No schema definition for 'Ort' (namespace '##local') in parent 'presentation' Generierung einer XMLType Tabelle mit Referenz zu einem XML Schema Anlegen einer XMLType Tabelle mit Referenz auf das registrierte XML Schema drop table Present; 17

18 create table Present of XMLType (CHECK (XMLIsValid(sys_nc_rowinfo$) = 1)) XMLSCHEMA " ELEMENT "presentation"; Tabelle wurde angelegt. descr Present; Name Null? Typ TABLE of SYS.XMLTYPE(XMLSchema " Element "presentation") STORAGE Object-relational 11. Generierung einer XMLType Tabelle mit Referenz zu einem XML Schema <xsl:stylesheet xmlns:xsl=" version="1.0"> <xsl:template match="/"> <html> <body bgcolor="#ffffff"> <table border="0"> <tr> <td><b>veranstaltung:</b></td> <td> <xsl:value-of select="/presentation/veranstaltung"/> </td> </tr> <tr> <td><b>termin:</b></td> <td> <xsl:value-of select="/presentation/termin"/> </td> </tr> <tr> <td><b>ort:</b></td> <td> <xsl:value-of select="/presentation/ort"/> </td> </tr> <tr> <td><b>thema:</b></td> <td> <xsl:value-of select="/presentation/thema"/> </td> </tr> </table> 18

19 <hr/> <p/> <b>referentin: </b> <xsl:value-of select="/presentation/referent/name"/>, <xsl:value-of select="/presentation/referent/funktion"/>, <xsl:value-of select="/presentation/referent/firma"/> </body> </html> </xsl:template> </xsl:stylesheet> Sonstiges Zugriff auf Repository per ftp ftp://localhost:2100/public/ Zugriff auf Demo Tabelle emp des Benutzers Scott mittels DBUriServlet Stylesheettransformation mit dem in die Oracle integrierten XSLT Prozessor &contenttype=text/html Kontaktadresse: Annegret Warnecke Oracle Deutschland GmbH Schloßstr Berlin Telefon: Fax: annegret.warnecke@oracle.com Internet: 19