削除式

削除式は、ノード・シーケンスからゼロ個以上のノードを削除します。

構文

構文図を読む
>>-delete--+-nodes-+--target-expression------------------------><
           '-node--'                      

delete nodes または delete node
削除式で始まるキーワード。 delete nodesまたはdelete nodeは、削除されるノードの数に関係なく有効です。
target-expression
更新式以外の XQuery 式。target-expression の結果は、ゼロ個以上のノードのシーケンスである必要があります。

削除式の結果は、削除されるノードのリストとなります。target-expression と一致するノードは、いずれも削除とマーク付けされます。target-expression と一致するノードがない場合、削除されるノードはありません。削除されたノードは親ノードから切り離されます。削除されたノード、およびそのノードの子は、ノード・シーケンスの一部ではなくなります。ノードの親のプロパティーが空の場合、エラーが戻されます。

ノードを挿入した結果、同じ親のテキスト・ノードが隣接する場合、隣接するテキスト・ノードは単一のテキスト・ノードにマージされます。結果として得られるテキスト・ノードのストリング値は、隣接するテキスト・ノードのストリング値を連結したものになります。 この場合、各ストリング値の間にスペースは追加されません。

例

purchaseOrder 文書が以下のようになっていると仮定します。

<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>

以下の SQL UPDATE ステートメントは、基本更新式を使用して、productName 値が "Lapis necklace" である品目を purchaseOrder 文書から削除します。

UPDATE purchaseOrders
 SET PO = XMLMODIFY(
 'declare namespace ipo="http://www.example.com/IPO";
 delete nodes /ipo:purchaseOrder/items/item[productName="Lapis necklace"]')

このステートメントの結果は、以下のようになります。

<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="945-ZG">
      <productName>Sapphire Bracelet</productName>
      <quantity>2</quantity>
      <USPrice>178.99</USPrice>
      <shipDate>2009-01-03</shipDate>
    </item>
  </items>
</ipo:purchaseOrder>