文書ノード・コンストラクター
すべての文書ノード・コンストラクターは、計算されるコンストラクターです。 文書ノード・コンストラクターは、括弧で囲まれた式に基づいてノードのコンテンツが計算される文書ノードを作成します。
文書ノード・コンストラクターは、照会の結果が完全な文書である場合に役立ちます。 文書ノード・コンストラクターの結果として、独自のノード 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>
