Скалярная функция XMLPI

>>-XMLPI--(--NAME--имя-ио--+------------------------+--)--------><
                           '-,--строковое-выражение-'

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

Функция XMLPI возвращает XML-значение с единственным узлом инструкции обработки XQuery.

NAME имя-ио

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

строковое-выражение

Выражение которое возвращает значение, являющееся строкой символов. Результирующая строка преобразуется в UTF-8 и должна соответствовать содержимому инструкции обработки XML, как определено в правилах XML 1.0 (SQLSTATE 2200T):

• Строка не должна содержать подстроки '?>', поскольку эта подстрока завершает инструкцию обработки
• Каждый символ в строке может быть любым символом Unicode, кроме X'FFFE' и X'FFFF'.

Результирующая строка становится содержимым конструируемого узла инструкции обработки.

Тип данных результата - XML. Если результат строкового-выражения может быть null, результат может быть null; если результат строкового-выражения - null, результат - значение null. Если строковое-выражение является пустой строкой или не задано, возвращается пустой узел инструкции обработки.

Примечания:

1. Поддержка в базах данных не-Unicode и базах данных с многими разделами: XMLPI не поддерживается (SQLSTATE 42997).

Примеры:

• Сгенерировать узел инструкции обработки XML.

     SELECT XMLPI (
       NAME "Instruction", 'Push the red button'
     )
     FROM SYSIBM.SYSDUMMY1
  

  Этот запрос вырабатывает следующий результат:

  <?Instruction Push the red button?>
  

• Сгенерировать пустой узел инструкции обработки XML.

  SELECT XMLPI (
       NAME "Warning"
     )
     FROM SYSIBM.SYSDUMMY1
  

  Этот запрос вырабатывает следующий результат:

  <?Warning ?>