Объявление XMLNAMESPACES

объявление-пространств-имен:
 
|--XMLNAMESPACES ------------------------------------------------>
 
      .-,--------------------------------------------------------.
      V                                                          |
>--(----+- uri-пространства-имен--AS--префикс-пространства-имен-+-+-)---|
        |                          (1)                         |
        '-+-DEFAULT--uri-пространства-имен------+--------------'
          '-NO DEFAULT--------------------------'

Примечания:

1. DEFAULT или NO DEFAULT могут быть заданы в аргументах XMLNAMESPACES только один раз.

Схема - SYSIBM. Имя объявления не может быть задано как квалифицированное имя.

Объявление XMLNAMESPACES конструирует объявления пространств имен из аргументов. Это объявление может использоваться только как аргумент специфичных функций, таких как XMLELEMENT, XMLFOREST и XMLTABLE. Результатом являются одно или более объявлений пространств имен XML, содержащих пространства имен в области видимости для каждого не-null входного значения.

uri-пространства-имен

Задает универсальный идентификатор ресурса (URI) пространства имен как строковую константу SQL. Эта строковая константа не должна быть пустой, если она используется с префиксом-пространства-имен (SQLSTATE 42815).

префикс-пространства-имен

Задает префикс пространства имен. Префикс является идентификатором SQL, который должен быть в форме XML NCName (SQLSTATE 42634). См. подробнее о допустимых именах в спецификациях пространства имен W3C. Префикс не должен быть xmlns и префикс должен быть уникальным в списке объявления пространств имен (SQLSTATE 42635).

DEFAULT uri-пространства-имен

Задает пространство имен по умолчанию для использования в области видимости данного объявления пространств имен. Uri-пространства-имен применяется для неквалифицированных имен в области видимости, если они не замещены в вложенной области видимости другим объявлением DEFAULT или объявлением NO DEFAULT.

NO DEFAULT

Задает, что нет пространства имен по умолчанию в области видимости данного объявления пространств имен. В области видимости нет пространства имен по умолчанию, кроме случаю замещения во вложенной области видимости объявлением DEFAULT.

Тип данных результата - XML. Результатом является объявление пространства имен XML для каждого заданного пространства имен. Результат не может быть null.

Примечания:

1. Поддержка в базах данных не-Unicode и базах данных с многими разделами: Объявления пространств имен по умолчанию должны быть явно отменены, чтобы избежать определенных ошибок в конструируемом XML-значении. Предопределенные префиксы пространств имен ('xs', 'xsi', 'xml' и 'sqlxml'), если они используются, также должны быть явно определены.

Примеры:

• Создать XML-элемент с именем adm:employee и атрибут XML с именем, оба связанные с пространством имен с префиксом adm.

     SELECT EMPNO, XMLELEMENT(
       NAME "adm:employee", XMLNAMESPACES(
         'http://www.adm.com' AS "adm"
       ),
       XMLATTRIBUTES(
         WORKDEPT AS "adm:department"
       ),
     LASTNAME
     )
     FROM EMPLOYEE
     WHERE JOB = 'ANALYST'
  

  Этот запрос вырабатывает следующий результат (форматирован для читабельности):

  000130 <adm:employee xmlns:adm="http://www.adm.com" adm:department="C01">
    QUINTANA</adm:employee>
  000140 <adm:employee xmlns:adm="http://www.adm.com" adm:department="C01">
    NICHOLLS</adm:employee> 
  200140 <adm:employee xmlns:adm="http://www.adm.com" adm:department="C01">
    NATZ</adm:employee>
  

• Создать XML-элемент с именем 'employee', который связан с пространством имен по умолчанию, и подэлемент с именем 'job', который не использует пространство имен по умолчанию, но чей подэлемент с именем 'department' использует пространство имен по умолчанию.

  SELECT EMP.EMPNO, XMLELEMENT(
       NAME "employee", XMLNAMESPACES(
         DEFAULT 'http://hr.org'
       ),
       EMP.LASTNAME, XMLELEMENT (
         NAME "job", XMLNAMESPACES(
           NO DEFAULT
         ),
         EMP.JOB, XMLELEMENT (
           NAME "department", XMLNAMESPACES(
             DEFAULT 'http://adm.org'
           ),
           EMP.WORKDEPT
         )
       )
     )
     FROM EMPLOYEE EMP
     WHERE EMP.EDLEVEL = 12
  

  Этот запрос вырабатывает следующий результат (форматирован для читабельности):

  000290 <employee xmlns="http://hr.org">PARKER<job xmlns="">OPERATOR
    <department xmlns="http://adm.org">E11</department></job></employee>
  000310 <employee xmlns="http://hr.org">SETRIGHT<job xmlns="">OPERATOR
    <department xmlns="http://adm.org">E11</department></job></employee>
  200310 <employee xmlns="http://hr.org">SPRINGER<job xmlns="">OPERATOR
    <department xmlns="http://adm.org">E11</department></job></employee>