XMLELEMENT 标量函数

1. xmlnamespaces-declaration 将对已构造元素添加一组名称空间作用域。 每个名称空间作用域会将名称空间前缀（或缺省名称空间）与名称空间 URI 相关联。 名称空间作用域将定义一组名称空间前缀，这些前缀可用于解释元素作用域内的 QNames。
2. 如果指定了 xmlattributes-function，那么会对其求值，结果是属性节点序列。
3. 将对每个 element-content-expression 求值，结果将转换为如下所示的节点序列：
   • 如果结果类型不是 XML ，那么会将其转换为 XML 文本节点，该节点的内容是根据 将 SQL 数据值映射到 XML 数据值 (请参阅 数据类型之间的强制类型转换中描述从非 XML 值到 XML 值的受支持强制类型转换的表)的规则映射到 XML 的 元素-内容-表达式 的结果。
   • 如果结果类型为 XML，那么一般来说结果是项序列。 该序列中的某些项可能是文档节点。 序列中的每个文档节点将替换为其顶级子代序列。 对于结果序列中的每个节点，将为该节点构造新的深层副本，包括其子代和属性。 每个复制节点都具有新的节点身份。 被复制元素和属性节点将保留其类型注释。 对于由序列中返回的一个或多个原子值组成的每个相邻序列，将构造新的文本节点（包含将每个原子值强制转换为字符串的结果），并会在相邻值之间插入单个空白字符。 内容序列中的相邻文本节点将通过并置内容（相邻值之间不插入空格）来合并成单个文本节点。 并置后，将从内容序列中删除内容为零长度字符串的任何文本节点。
4. XML 属性的结果序列和所有 element-content-expression 指定结果序列将并置成为一个序列，称为内容序列。 内容序列中的相邻文本节点的任何序列将合并成单个文本节点。 如果所有 element-content-expression 自变量都是空字符串，或者未指定 element-content-expression 自变量，那么会返回空元素。
5. 内容序列只能包含后跟属性节点的属性节点 (SQLSTATE 10507)。 内容序列中出现的属性节点将成为新元素节点的属性。 在这些属性节点中，一定不能有两个或两个以上属性节点同名 (SQLSTATE 10503)。 如果名称空间 URI 不在已构造元素的名称空间作用域中，那么将创建对应于属性节点名称中使用的任何名称空间的名称空间声明。
6. 内容序列中的元素、文本、注释和处理指令将成为已构造元素节点的子代。
7. 已构造元素节点的类型注释被指定为 xs:anyType，它的每个属性的类型注释被指定为 xdt:untypedAtomic。 已构造元素节点的节点名是在 NAME 关键字之后指定的元素名称。

• XMLNAMESPACES 声明中声明的名称空间是由 XMLELEMENT 函数构造的元素节点的名称空间作用域。 如果元素节点已序列化，那么它的每个名称空间作用域将作为名称空间属性序列化，除非它是元素节点父代的名称空间作用域，而父代元素也已序列化。
• 如果 XMLQUERY 或 XMLEXISTS 在 element-content-expression 中，那么这些名称空间将成为 XMLQUERY 或 XMLEXISTS 的 XQuery 表达式的静态已知名称空间。 静态已知名称空间用于解析 XQuery 表达式中的 QNames。 如果 XQuery 序言在 XQuery 表达式作用域中使用同一前缀声明名称空间，那么序言中声明的名称空间将覆盖 XMLNAMESPACES 声明中声明的名称空间。
• 如果已构造元素的属性来自 element-content-expression，那么其名称空间可能尚未声明为已构造元素的名称空间作用域，在此情况下，将其为其创建新的名称空间。 如果这将导致冲突，这意味着属性名称的前缀已由作用域内名称空间绑定到另一 URI ，那么将生成不会导致此类冲突的前缀，并且属性名称中使用的前缀将更改为新前缀，并且将为此新前缀创建名称空间。 生成的新前缀将遵循以下模式：“db2ns-xx”，其中“x”是从集合 [A-Z、a-z 和 0-9] 中选择的字符。 例如：

     VALUES XMLELEMENT(
       NAME "c", XMLQUERY(
         'declare namespace ipo="www.ipo.com"; $m/ipo:a/@ipo:b'
           PASSING XMLPARSE(
             DOCUMENT '<tst:a xmlns:tst="www.ipo.com" tst:b="2"/>'
           ) AS "m"
       )
     )

  返回：

  <c xmlns:tst="www.ipo.com" tst:b="2"/>

  第二个示例：

     VALUES XMLELEMENT(
       NAME "tst:c", XMLNAMESPACES(
         'www.tst.com' AS "tst"
       ),
       XMLQUERY(
         'declare namespace ipo="www.ipo.com"; $m/ipo:a/@ipo:b'
           PASSING XMLPARSE(
             DOCUMENT '<tst:a xmlns:tst="www.ipo.com" tst:b="2"/>'
           ) AS "m"
       )
     )

  返回：

  <tst:c xmlns:tst="www.tst.com" xmlns:db2ns-a1="www.ipo.com"
    db2ns-a1:b="2"/>

   SELECT E.FIRSTNME, E.LASTNAME, XMLELEMENT(
     NAME "Emp", XMLELEMENT(
       NAME "firstname", E.FIRSTNME
     ), 
     XMLELEMENT(
       NAME "lastname", E.LASTNAME
     )
     OPTION NULL ON NULL
   )
   AS "Result"
   FROM EMPLOYEE E
   WHERE E.EDLEVEL = 12

FIRSTNME     LASTNAME        Emp
JOHN         PARKER          <Emp><firstname>JOHN</firstname>
                               <lastname>PARKER</lastname></Emp>
MAUDE        SETRIGHT        <Emp><firstname>MAUDE</firstname>
                               <lastname>SETRIGHT</lastname></Emp>
MICHELLE     SPRINGER        <Emp><firstname>MICHELLE</firstname>
                               <lastname>SPRINGER</lastname></Emp>

   SELECT XMLELEMENT(
     NAME "Department", XMLATTRIBUTES(
       E.WORKDEPT AS "name"
     ),
     XMLAGG(
       XMLELEMENT(
         NAME "emp", E.FIRSTNME
       )
       ORDER BY E.FIRSTNME
     )
   )
   AS "dept_list"
   FROM EMPLOYEE E
   WHERE E.WORKDEPT IN ('A00', 'B01')
   GROUP BY WORKDEPT

dept_list
<Department name="A00">
<emp>CHRISTINE</emp>
<emp>SEAN</emp>
<emp>VINCENZO</emp>
</Department>
<Department name="B01">
<emp>MICHAEL</emp>
</Department>

SELECT XMLELEMENT(
         NAME "root",
         XMLNAMESPACES(DEFAULT 'http://mytest.uri'),
         XMLATTRIBUTES(cid),
            (SELECT 
               XMLAGG(
                 XMLELEMENT( 
                   NAME "poid", poid
                 )
               )
             FROM purchaseorder
             WHERE purchaseorder.custid = customer.cid 
            )
       )
FROM customer 
WHERE cid = '1002'

<root xmlns="http://mytest.uri" CID="1002">
  <poid>5000</poid>
  <poid>5003</poid>
  <poid>5006</poid>
</root>