Выражение XMLCAST

xmlcast-выражение:
 
|--XMLCAST--(--+-выражение--------+--AS--тип-данных--)-----------|
               +-NULL-------------+
               '-маркер-параметра-'
 

Выражение XMLCAST возвращает операнд преобразования (первый операнд), преобразованный в заданный тип данных. XMLCAST поддерживает преобразования XML-значений, включая преобразования между типами данных не-XML и типами данных XML. Если преобразование не поддерживается, возвращается ошибка (SQLSTATE 22003).

Выражение XMLCAST поддерживается только в базах данных Unicode с одним разделом базы данных (SQLSTATE 42997).

выражение

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

NULL

Если операнд преобразования является ключевым словом NULL, целевой тип данных должен быть типом данных XML (SQLSTATE 42846). Результат является неопределенным (null) XML-значением.

маркер-параметра

Если операнд преобразования является маркером параметра, целевой тип данных должен быть XML (SQLSTATE 42846). Маркер параметра (задаваемый как знак вопроса) обычно рассматривается как выражение, но этот случай оговаривается отдельно, поскольку он имеет специальный смысл. Если операнд преобразования является маркером параметра, заданный тип данных рассматривается как могущий при замещении быть присвоенным заданному (XML) типу данных (при помощи присваивания в памяти). Такой маркер параметра рассматривается как типизированный маркер параметра, который трактуется как и другие типизированные значения в функциях, описаниях операций в списке выборки или присваиваниях значений столбцам.

тип-данных

Имя существующего типа данных SQL. Если имя If the name is not qualified, the SQL path is used to perform data type resolution. Если тип данных имеет связанные с ним атрибуты, такие как длина, точность и т.п., эти атрибуты должны быть включены в задание значения типа-данных. CHAR по умолчанию имеет длину 1, а DECIMAL по умолчанию имеет всего 5 цифр и 0 цифр после точки. Ограничения на поддерживаемые типы данных основываются на заданном операнде преобразования.

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

Примеры

• Создание неопределенного XML-значения:

     XMLCAST(NULL AS XML)
  

• Преобразование значения, выделенного из выражения XMLQUERY, в INTEGER:

     XMLCAST(XMLQUERY('$m/PRODUCT/QUANTITY'
         PASSING BY REF xmlcol AS "m" RETURNING SEQUENCE) AS INTEGER)
  

• Преобразование значения, выделенного из выражения XMLQUERY, в символьную строку переменной длины:

     XMLCAST(XMLQUERY('$m/PRODUCT/ADD-TIMESTAMP'
        PASSING BY REF xmlcol AS "m" RETURNING SEQUENCE) AS VARCHAR(30))
  

• Преобразование значения, выделенного из скалярного подзапроса SQL в значение XML:

     XMLCAST((SELECT quantity FROM product AS p
        WHERE p.id = 1077) AS XML)