Как зарегистрировать схему XML в БД и как этим воспользоваться

© Владимир Пржиялковский

Чиновник по особым порученьям,
Который их до места проводил,
С заботливым Попова попеченьем
Сдал на руки дежурному.

А. К. Толстой. Сон Попова

Аннотация

Установленная в БД XML DB позволяет регистрировать в базе схемы XML с описаниями разных типов документов XML. Зарегистрированная в репозитарии схема может употребляться для данных типа XMLTYPE: как хранимых в обычных таблицах, так и доступных из производных (синтезированных) таблиц типа XMLTYPE. В статье показано на примерах, как можно это выполнять.

Введение

Эта статья является продолжением ранее опубликованных статей «XML DB - новое измерение в организации данных в Oracle» и «Что дает репозитарий XML DB и как с ним работать». Здесь говорится о регистрации в БД пользователя схем XML, что возможно после установки XML DB (об этом рассказывалось ранее). Показано, как выполняется регистрация, и как зарегистрированную схему XML можно использовать при работе с данными типа XMLTYPE. 

Как зарегистрировать схему XML

Рассмотрим несложную схему XML, определение которой создадим в файле bookCover. xsd :

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">

  <xsd:element name="cover" type="coverType"/>

    <xsd:complexType name="coverType">

      <xsd:sequence>

        <xsd:element name="title" type="xsd:string"/>

        <xsd:element name="author" type="xsd:string"

                     maxOccurs="unbounded"/>

        <xsd:element name="publisher" type="xsd:string"/>

        <xsd:element name="pubdate" type="xsd:string"/>

        <xsd:element name="isbn" type="xsd:string"/>

        <xsd:element name="pages" type="xsd:string"/>

      </xsd:sequence>

    </xsd:complexType>

</xsd:schema>

Поместим файл bookCover. xsd в репозитарий XML DB в папку /public (любым методом: командной строкой, программно, графическим способом, по WebDAV или FTP). Получим ресурс /public /bookCover.xsd репозитария. Зарегистрируем схему, являющуюся содержанием этого ресурса, с помощью пользователя SCOTT.

Для возможности регистрации схемы пользователь БД должен обладать привилегиями

ALTER SESSION

CREATE TYPE

CREATE TABLE

CREATE PROCEDURE

CREATE TRIGGER

В версии 10 содержание роли CONNECT было сведено только к привилегии CREATE SESSION, поэтому после версии 9 пользователю SCOTT потребуется так или иначе выдать привилегию ALTER SESSION, например:

CONNECT / AS SYSDBA

GRANT ALTER SESSION TO scott;

CONNECTscott/tiger

Следующая далее команда не является технологической необходимостью и выдается для возможности дальнейшего анализа произошедшего:

ALTER SESSION SET EVENTS='31098 trace name context forever';

Регистрация:

BEGIN

DBMS_XMLSCHEMA.REGISTERSCHEMA (

  schemaurl => 'http://localhost:8080/public/bookCover.xsd'

, schemadoc => XDBURITYPE ( '/public/bookCover.xsd' )

);

END;

/

Описание схемы не обязательно заводить в репозитарии в качестве ресурса. Для регистрации можно воспользоваться и внешним файлом, явно указанным документом XML или же документом, указанным через внешний URL (подтипы URITYPE).

Проверка:

SQL> COLUMN schema_url FORMAT A50 WORD

SQL> COLUMN local      FORMAT A5

SQL> SELECT schema_url, local FROM user_xml_schemas;

SCHEMA_URL                                         LOCAL

-------------------------------------------------- -----

http://localhost:8080/public/bookCover.xsd         YES

Интерес представляют также другие поля таблицы USER_XML_SCHEMAS, не указанные в этом запросе за экономией места. Например, поле QUAL_SCHEMA_URL указывает на полное (реальное), а не сокращенное имя ресурса, созданного в результате регистрации схемы: в нашем случае / sys / schemas / SCOTT / localhost :8080/ public /bookCover.xsd. Если бы регистрируя схему мы объявили ее глобальной (что требует явного указания и наличия прав), полный адрес ресурса был бы иной: / sys / schemas / PUBLIC / localhost :8080/public/bookCover.xsd.

Выдача команды ALTER SESSION выше привела к фиксации в трассировочном файле сеанса некоторых скрытых действий СУБД, например:

CREATE OR REPLACE TYPE "SCOTT"."author342_COLL" AS VARRAY(2147483647) OF VARCHAR2(4000 CHAR)

/

CREATE OR REPLACE TYPE "SCOTT"."coverType341_T" AS OBJECT ("SYS_XDBPD$" "XDB"."XDB$RAW_LIST_T","title" VARCHAR2(4000 CHAR),"author" "author342_COLL","publisher" VARCHAR2(4000 CHAR),"pubdate" VARCHAR2(4000 CHAR),"isbn" VARCHAR2(4000 CHAR),"pages" VARCHAR2(4000 CHAR))NOT FINAL INSTANTIABLE

/

CREATE TABLE "SCOTT"."cover343_TAB" OF SYS.XMLTYPE  XMLSCHEMA "http://localhost:8080/public/bookCover.xsd" ID '6927F846BBDA487F84B9BCCEC191A059' ELEMENT "cover" ID 2664  TYPE "SCOTT"."coverType341_T"

/

Результат этих действий, а также созданную заодно триггерную процедуру "cover343_TAB$xd" (в нашем случае), можно наблюдать в таблице USER_OBJECTS. ( Упражнение . Узнать из таблицы USER_OBJECTS перечень появившихся после регистрации схемы XML объектов). Обратите внимание, что сведения о таблице "cover343_TAB" не отражены в USER_TABLES, хотя представлены в прочих системных таблицах, например, в USER_TAB_COLUMNS и USER_TAB_COLS.

Эти сопутствующие объекты будут технически использоваться для организации хранения данных XMLTYPE, уточненных зарегистрированной схемой. Для возможно повторяющегося элемента author хранение организовано в виде массива VARRAY.

Если мы захотим снять схему с регистрации, да еще удалить эти сопутствующие объекты, нужно при вызове соответствующей процедуры указать особое значение специальному параметру:

BEGIN

DBMS_XMLSCHEMA.DELETESCHEMA (

  schemaurl     => 'http://localhost:8080/public/bookCover.xsd'

, delete_option => DBMS_XMLSCHEMA.DELETE_CASCADE

);

END;

/

Для краткости (но в ущерб ясности кода) можно сразу указать цифровое значение, например в SQL*Plus:

EXECUTE DBMS_XMLSCHEMA -

        .DELETESCHEMA ( 'http://localhost:8080/public/bookCover.xsd', 3 )

Использование зарегистрированной схемы

Проверка действия схемы

Метод CREATESCHEMABASEDXML типа XMLTYPE позволяет устроить проверку соответствия документа XML схеме.

Ради краткости записи следующих примеров имя зарегистрированной схемы занесем в переменную SQL*Plus:

VARIABLE bookschema VARCHAR2 ( 100 )

EXECUTE :bookschema := 'http://localhost:8080/public/bookCover.xsd'

Следующие запросы проработают без ошибок:

SELECT

 XMLTYPE ( '<cover></cover>' ).CREATESCHEMABASEDXML ( :bookschema )

FROM dual

;

SELECT

 XMLTYPE ( '<cover><author>Einstein</author></cover>' )

 .CREATESCHEMABASEDXML ( :bookschema )

FROM dual

;

SELECT

 XMLTYPE (

 '

 <cover>

  <title>Java Programming with Oracle JDBC</title>

  <author>Donald Bales</author>

  <publisher>OReilly and Associates</publisher>

  <pubdate>December 2001</pubdate>

  <isbn>0-596-00088-x</isbn>

  <pages>496</pages>

 </cover>

 ' ).CREATESCHEMABASEDXML ( :bookschema )

FROM dual

;

Следующие запросы проработают с ошибками ввиду противоречий документа схеме:

SELECT

 XMLTYPE ( '<c/>' ).CREATESCHEMABASEDXML ( :bookschema )

FROM dual

;

SELECT

 XMLTYPE ( '<cover><a>Einstein</a></cover>' )

 .CREATESCHEMABASEDXML ( :bookschema )

FROM dual

;

SELECT

 XMLTYPE ( '<cover><title>A</title><title>B</title></cover>' )

 .CREATESCHEMABASEDXML ( :bookschema )

FROM dual

;

Использование для дополнительной типизации XMLTYPE в базовых таблицах

Просто указанный XMLTYPE требует лишь, чтобы помещаемый в БД документ был правильно оформлен. Зарегистрированная в XML DB схема XML позволяет указать для размещаемых в конкретные поля документов XML-образные ограничения целостности, позволяя хранить только «правильные» (valid) из них.

Создадим таблицу объектов XMLTYPE, уточненную ссылкой на зарегистрированную схему:

CREATE TABLE xtbooks OF XMLTYPE

XMLSCHEMA "http://localhost:8080/public/bookCover.xsd"

ELEMENT "cover"

;

Проверка занесения данных:

INSERT INTO xtbooks VALUES (

XMLTYPE ( '<cover><author>Einstein</author></cover>' )

);

INSERT INTO xtbooks VALUES (

 XMLTYPE ( '

 <cover>

  <title>Java Programming with Oracle JDBC</title>

  <author>Donald Bales</author>

  <publisher>OReilly and Associates</publisher>

  <pubdate>December 2001</pubdate>

  <isbn>0-596-00088-x</isbn>

  <pages>496</pages>

 </cover>

 ' )

);

COMMIT;

Упражнение. Проверьте реакцию СУБД на попытку вставить в таблицу XTBOOKS правильно оформленный документ XML, не соответствующий описанию схемы.

Аналогично накладываются дополнительные ограничения на данные столбца XMLTYPE в обычной таблице:

CREATE TABLE tbooks  (

  id          NUMBER ( 9 )

, description XMLTYPE

)

XMLTYPE description STORE AS OBJECT RELATIONAL

XMLSCHEMA "http://localhost:8080/public/bookCover.xsd"

ELEMENT "cover"

;

В приведенных примерах данные в БД фактически будут храниться «объектно-реляционно», то есть будучи распределены по разным структурам БД, в том числе по спрятанным столбцам таблиц. Однако типизируя таблицу или столбец типа XMLTYPE схемой, можно потребовать фактического хранения документа в виде объекта CLOB, подобно тому, как это происходит при отсутствии типизации схемой.

Пример:

CREATE TABLE xtbooksclob OF XMLTYPE

XMLTYPE STORE AS CLOB

XMLSCHEMA "http://localhost:8080/public/bookCover.xsd"

ELEMENT "cover"

;

Упражнение. Проверить возникновение новых объектов БД и их структуры по результатам заведения таблиц XTBOOKS, TBOOKS и XTBOOKSCLOB. Воспользоваться для этого таблицами USER_OBJECTS, USER_TAB_COLS, USER_TYPES, USER_TRIGGERS, USER_LOBS.

Использование для дополнительной типизации XMLTYPE в производных таблицах (views)

При отсутствии XML DB не запрещено создавать производную таблицу (view), выдающую данные в виде таблицы документов XML (типа XMLTYPE) на основе данных из обычных таблиц. Рассмотрим, как при наличии XML DB можно дополнительно уточнить такую производную таблицу схемой XML.

В этом примере регистрируется схема, не взятая из ресурса репозитария, как ранее, а явно выписанная в виде текста XML:

BEGIN

DBMS_XMLSCHEMA.REGISTERSCHEMA (

  schemaurl => 'http://localhost:8080/public/employee.xsd'

, schemadoc =>

  '<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

     <xs:element name="employee">

       <xs:complexType>

         <xs:sequence>    

           <xs:element name="ename" type="xs:string"/>

           <xs:element name="job" type="xs:string"/>

           <xs:element name="sal" type="xs:integer"/>

         </xs:sequence>

         <xs:attribute name="empno" type="xs:integer"/>

       </xs:complexType>

     </xs:element>

   </xs:schema>

  '

);

END;

/

Пример создания производной таблицы:

CREATE OR REPLACE VIEW empxml_schema_view OF XMLTYPE

XMLSCHEMA "http://localhost:8080/public/employee.xsd"

ELEMENT "employee"

WITH OBJECT ID

 ( EXTRACT ( SYS_NC_ROWINFO$, '/employee/@empno' ).GETNUMBERVAL ( ) )

AS

SELECT

  XMLELEMENT (

    "employee"

  , XMLATTRIBUTES ( e.empno AS "empno" )

  , XMLFOREST ( e.ename AS "ename", e.job AS "job", e.sal AS "sal" )

  )

FROM emp e

;

Наличие данных, противоречащих схеме, не препятствует извлечению данных результата при обращении к созданной производной таблице. Однако ж имеется метод, способный выполнить проверку соответствия схеме:

SELECT VALUE ( v ).ISSCHEMAVALID ( ) FROM empxml_schema_view v;

Упражнение. Создать производную таблицу EMLXML_VIEW по аналогии с EMLXML_SCHEMA_VIEW, не уточненной схемой (для этого потребуется удалить из определения выше две строки, выделенные жирным шрифтом). Выполнить следующие проверки:

SELECT VALUE ( v ).ISSCHEMAVALID ( ) FROM empxml_view v;

SELECT

  VALUE ( v )

  .ISSCHEMAVALID ( 'http://localhost:8080/public/employee.xsd' )

FROM empxml_view v

;

Упражнение. Внести в схему http://localhost:8080/public/employee.xsd пользователя SCOTT изменение (снять с регистрации и зарегистрировать исправленный текст). Заменить в схеме существующее описание зарплаты:

           <xs:element name="sal" type="xs:integer"/>

на следующее:

           <xs:element name="sal">

             <xs:simpleType>

               <xs:restriction base="xs:integer">

                 <xs:maxInclusive value="1500"/>

                 <xs:minInclusive value="1000"/>

               </xs:restriction>

             </xs:simpleType>

           </xs:element>

Проверить поведение последних трех упоминавшихся выше запросов.

Последний пример показывает использование чуть более сложных ограничений целостности на структуру и данные документов XML (минимальное и максимальное значения зарплат).


Страница сайта http://test.interface.ru
Оригинал находится по адресу http://test.interface.ru/home.asp?artId=2802