文書ノード・コンストラクター

すべての文書ノード・コンストラクターは、計算されるコンストラクターです。 文書ノード・コンストラクターは、括弧で囲まれた式に基づいてノードのコンテンツが計算される文書ノードを作成します。

文書ノード・コンストラクターは、照会の結果が完全な文書である場合に役立ちます。 文書ノード・コンストラクターの結果として、独自のノード ID を持つ新しい文書ノードになります。

重要: 構成された文書ノードでは、妥当性検査は実行されません。 XQuery 文書ノード・コンストラクターは、XML 文書の構造を管理する XML 1.0 規則を適用しません。 例えば、文書ノードは、エレメント・ノードである正確に 1 個の子を持つ必要はありません。

構文

構文図を読む
>>---document--{--content-expression--}------------------------><

document
この後に続くテキストが文書ノードを構成することを示すキーワード。
content-expression
構成される文書ノードのコンテンツを生成する式。 content-expression の値として、ノードやアトミック値からなる任意のシーケンスが可能です (属性ノードを除く)。 コンテンツ・シーケンスに属性ノードが含まれる場合、結果としてエラーになります。 コンテンツ・シーケンス内の文書ノードは、その子に置き換わります。 content-expression によって戻されるノードごとに、ノードとそのすべての子孫の新規コピーが作成されます。このコピーには元のタイプ・アノテーションが保持されます。 コンテンツ式によって戻されるアトミック値は、ストリングに変換され、テキスト・ノードに保管されます。 これらは、構成される文書ノードの子になります。 隣接する複数のテキスト・ノードは、1 つのテキスト・ノードにマージされます。

例

以下の照会の文書ノード・コンストラクターには、XML 文書を戻すコンテンツ式が含まれています。 XML 文書には item-list という名前のルート・エレメントが含まれます。
SELECT XMLQUERY(
  'declare namespace ipo="http://www.example.com/IPO";
  let $i := $po/ipo:purchaseOrder/items/item
  return
    document
    {
      <item-list>
       {$i}
      </item-list>
    }'
  PASSING XMLAGG(PORDER) as "po")
FROM PURCHASEORDER

PURCHASEORDER 表の列 PORDER に、以下のデータが含まれているとします。

<ipo:purchaseOrder
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:ipo="http://www.example.com/IPO"
   orderDate="2008-12-01">
  <shipTo exportCode="1" xsi:type="ipo:UKAddress">
    <name>Helen Zoe</name>
    <street>55 Eden Street</street>
    <city>San Jose</city>
    <state>CA</state>
    <postcode>CB1 1JR</postcode>
  </shipTo>
  <shipTo exportCode="1" xsi:type="ipo:UKAddress">
    <name>Joe Lee</name>
    <street>66 University Avenue</street>
    <city>Palo Alto</city>
    <state>CA</state>
    <postcode>CB1 1JR</postcode>
  </shipTo>
  <billTo xsi:type="ipo:USAddress">
    <name>Robert Smith</name>
    <street>8 Oak Avenue</street>
    <city>Old Town</city>
    <state>PA</state>
    <zip>95819</zip>
  </billTo>
  <items>
    <item partNum="833-AA">
      <productName>Lapis necklace</productName>
      <quantity>1</quantity>
      <USPrice>99.95</USPrice>
      <ipo:comment>Want this for the holidays!</ipo:comment>
      <shipDate>2008-12-05</shipDate>
    </item>
    <item partNum="945-ZG">
      <productName>Sapphire Bracelet</productName>
      <quantity>2</quantity>
      <USPrice>178.99</USPrice>
      <shipDate>2009-01-03</shipDate>
    </item>
  </items>
</ipo:purchaseOrder>

この照会は、次の結果を戻します。

<item-list>
  <item xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:ipo="http://www.example.com/IPO" partNum="833-AA">
    <productName>Lapis necklace</productName>
    <quantity>1</quantity>
    <USPrice>99.95</USPrice>
    <ipo:comment>Want this for the holidays!</ipo:comment>
    <shipDate>2008-12-05</shipDate>
  </item>
  <item xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:ipo="http://www.example.com/IPO" partNum="945-ZG">
    <productName>Sapphire Bracelet</productName>
    <quantity>2</quantity>
    <USPrice>178.99</USPrice>
    <shipDate>2009-01-03</shipDate>
  </item>
</item-list>