XMLELEMENT スカラー関数

1. xmlnamespaces-declaration は、構成されたエレメントの有効範囲内の名前空間のセットを追加します。 それぞれの有効範囲内の名前空間は、名前空間接頭部 (またはデフォルトの名前空間) を、名前空間 URI と関連付けます。 有効範囲内の名前空間は、エレメントの有効範囲内の QNames の解釈に使用できる名前空間接頭部のセットを定義します。
2. xmlattributes-function を指定した場合、それが評価され、結果は属性ノードのシーケンスになります。
3. それぞれの element-content-expression は評価され、結果は以下のようにノードのシーケンスに変換されます。
   • 結果のタイプが XML でない場合は、XML にマッピングされる element-content-expression の結果が内容である、XML テキスト・ノードに変換されます。 このマッピングは、SQL データ値から XML データ値へのマッピングの規則に従います (『データ・タイプ間のキャスト』の非 XML 値から XML 値へのサポートされるキャストを説明する表を参照)。
   • 結果タイプが XML である場合、一般に結果は項目のシーケンスになります。 そのシーケンス内のいくつかの項目は、文書ノードである場合があります。 シーケンス内の各文書ノードは、その最上位の子のシーケンスによって置き換えられます。 次いで結果のシーケンス内の各ノードに対して、その子と属性を組み込んだノードの新しいディープ・コピーが構成されます。 コピーされた各ノードは、新しいノード ID を持ちます。 コピーされたエレメントおよび属性ノードは、それぞれのタイプのアノテーションを保持します。 シーケンス内で戻される 1 つ以上の原子値の隣接する各シーケンスごとに、新規テキスト・ノードが構成され、隣接値の間に単一ブランク文字が挿入された、ストリングに対する各原子値のキャストの結果が含まれます。 内容のシーケンス内の隣接するテキスト・ノードは、ブランクを間に挟まずにその内容を連結して単一のテキスト・ノードにマージされます。 連結後に、内容がゼロ長ストリングであるテキスト・ノードは、内容のシーケンスから削除されます。
4. XML 属性の結果のシーケンス、およびすべての element-content-expression 指定の結果のシーケンスは、内容シーケンスと呼ばれる 1 つのシーケンスに連結されます。 内容シーケンス内の隣接するテキスト・ノードのすべてのシーケンスは、単一のテキスト・ノードにマージされます。 すべての element-content-expression 引数が空ストリングである場合、または element-content-expression 引数が指定されていない場合、空のエレメントが戻されます。
5. 内容シーケンスには、属性ノードではないノードに続けて属性ノードを含めることはできません (SQLSTATE 10507)。 内容シーケンス内の属性ノードは、新規エレメント・ノードの属性になります。 これらの属性ノードの複数が同じ名前を持つことはできません (SQLSTATE 10503)。 名前空間 URI が、構成されたエレメントの有効範囲内名前空間にない場合、名前空間宣言は、属性ノードの名前で使用されるすべての名前空間に対応して作成されます。
6. 内容シーケンス内のエレメント、テキスト、コメント、および処理命令ノードは、構成されたエレメント・ノードの子になります。
7. 構成されたエレメント・ノードには xs:anyType のタイプ・アノテーションが与えられ、その各属性には xdt:untypedAtomic のタイプ・アノテーションが与えられます。 構成されたエレメント・ノードのノード名は、NAME キーワードの後に指定された element-name です。

• XMLNAMESPACES declaration で宣言された名前空間は、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"/>

  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>