構成されるエレメントの範囲内の名前空間

構成されるエレメント・ノードは、名前空間バインディングのセットからなる、範囲内の名前空間プロパティーを持ちます。 それぞれの名前空間バインディングは、名前空間接頭部を URI に関連付けます。 名前空間バインディングは、エレメントの有効範囲内の修飾名 (QName) を解釈するために使用できる名前空間接頭部のセットを定義します。

重要: このトピックについて理解するには、以下の概念の相違点を理解しておく必要があります。
静的に既知の名前空間
静的に既知の名前空間 は、式のプロパティーです。 このプロパティーは、式の処理中に名前空間の接頭部を解決するために XQuery によって使われる名前空間バインディングのセットを示します。 これらのバインディングは、照会結果には含まれません。
範囲内の名前空間
範囲内の名前空間 は、エレメント・ノードのプロパティーです。 このプロパティーは、エレメントとその内容が処理されるときに XQuery 外部のアプリケーションで使用できる名前空間バインディングのセットを示します。 これらのバインディングは、外部のアプリケーションで使用できるよう、照会結果の一部としてシリアライズされます。
構成されるエレメントの範囲内の名前空間には、以下の方法で作成されるすべての名前空間バインディングが含まれます。
  • 明示的に、名前空間宣言属性を介して。

    以下のコンストラクターで宣言される名前空間宣言属性ごとに、名前空間バインディングが作成されます。

    • 現在のエレメント・コンストラクター
    • 括弧で囲まれた直接エレメント・コンストラクター (現在のエレメント・コンストラクターや中間コンストラクターによって名前空間宣言属性がオーバーライドされない場合)。
  • システムによって自動的に。

    以下の状況で名前空間バインディングが作成されます。

    • 構成されるエレメントごとに、接頭部 xml を名前空間 URI http://www.w3.org/XML/1998/namespace にバインドするために。
    • 構成されるエレメントの名前やその属性の名前で使われるそれぞれの名前空間のために (エレメントの範囲内の名前空間の中にまだ名前空間バインディングが存在しない場合)。 ノードの名前に接頭部が含まれる場合、名前空間バインディングでその接頭部が使用されます。 名前に接頭部がない場合、空の接頭部のバインディングが作成されます。 同じ接頭部の 2 つの異なるバインディングを必要とするような競合が発生した場合、ノード名で使われる接頭部が任意の接頭部に変更され、その任意の接頭部の名前空間バインディングが作成されます。
      重要: QName で使用される接頭部は、有効な URI に解決される必要があります。 そうでない場合、エレメントの範囲内の名前空間にその接頭部のバインディングを追加することはできません。 QName を解決できない場合、式の結果はエラーとなります。

例

以下の照会には、名前空間宣言を含むプロローグと、直接エレメント・コンストラクターを含む本体が組み込まれています。
SELECT XMLQUERY(
 'declare namespace p="http://example.com/ns/p";
  declare namespace q="http://example.com/ns/q";
  declare namespace f="http://example.com/ns/f";
  <p:newElement q:b="B900" xmlns:r="http://example.com/ns/r"/>')
FROM SYSIBM.SYSDUMMY1
プロローグ内の名前空間宣言は、式の静的に既知の名前空間に名前空間バインディングを追加します。 ただし、構成されるエレメントの範囲内の名前空間に名前空間バインディングが追加されるのは、コンストラクター内の QName がこれらの名前空間を使用する場合のみです。 したがって、p:newElement の範囲内の名前空間は、以下の名前空間バインディングからなります。
  • p = "http://example.com/ns/p" - 接頭部 p が QName p:newElement の中にあるため、範囲内の名前空間にこの名前空間バインディングが追加されます。
  • q = "http://example.com/ns/q" - 接頭部 q が属性 QName q:b の中にあるため、範囲内の名前空間にこの名前空間バインディングが追加されます。
  • r = "http://example.com/ns/r" - この名前空間バインディングは、名前空間宣言属性で定義されているため、範囲内の名前空間に追加されます。
  • xml = "http://www.w3.org/XML/1998/namespace" - この名前空間バインディングは、構成される各エレメント・ノードに対して定義されるため、範囲内の名前空間に追加されます。

名前空間 f="http://example.com/ns/f" のためのバインディングは、範囲内の名前空間に追加されません。 これは、接頭部 f を使用するエレメント名や属性名が、エレメント・コンストラクターに含まれないためです。 したがって、この名前空間バインディングは (静的に既知の名前空間の中に存在し、照会の処理中に使用可能であっても) 照会結果には表示されません。

この照会は以下の結果を戻します。

<p:newElement xmlns:q="http://example.com/ns/q"
              xmlns:r="http://example.com/ns/r"
              xmlns:p="http://example.com/ns/p"
              q:b="B900"/>

以下の照会は、名前空間バインディングが照会結果の生成に使用されない場合、構成されるエレメントの範囲内の名前空間にその名前空間バインディングが追加されないことを示しています。

SELECT XMLQUERY(
  'declare namespace p="http://example.com/ns/p";
  <newdoc>
    { $d/p:element1/p:element2 }
  </newdoc>'
  PASSING XMLPARSE(DOCUMENT 
  '<p2:element1 xmlns:p2="http://example.com/ns/p">
     <p2:element2>New element</p2:element2>
   </p2:element1>')
  as "d")
FROM SYSIBM.SYSDUMMY1

照会に p が出現しても、名前空間バインディング p="http://example.com/ns/p" は p:element2 の範囲内の名前空間に追加されません。

この照会は以下の結果を戻します。

<newdoc>
  <p2:element2 xmlns:p2="http://example.com/ns/p">
    New element
  </p2:element2>
</newdoc>