XML 文書全体の更新

XML 列内で XML 文書全体を更新するには、SQL UPDATE ステートメントを使用します。特定の行を更新したいときは、WHERE 文節を組み込みます。

変更の始まりXML 列への入力は、XML 1.0 仕様に定義されているとおりの整形式 XML 文書であることが必要です。 文書ノードがまだ存在しない場合は、それが暗黙的に作成されます。 アプリケーション・データ・タイプは、XML (XML AS BLOB、XML AS CLOB、XML AS DBCLOB)、 文字、またはバイナリー・タイプとすることができます。変更の終わり

アプリケーション内の XML データは、 テキスト XML 形式、または拡張可能動的バイナリー XML Db2® クライアント/サーバー・バイナリー XML 形式 (バイナリー XML 形式) にすることができます。バイナリー XML 形式は、JDBC アプリケーション、SQLJ アプリケーション、および ODBC アプリケーションでのみ有効です。XML 列のデータを更新する場合、データを XML 階層形式に変換する必要があります。ホスト変数からの XML データを使って XML 列を直接更新するときには、Db2 データベース・サーバーがこの操作を暗黙的に実行します。 あるいは、更新操作実行時に XMLPARSE 関数を明示的に呼び出して、 データを XML 階層形式に変換することができます。

XML 列を更新するとき、登録済みの XML スキーマに照らして入力 XML 文書を妥当性検査することもできます。以下のいずれかの方法で行うことができます。
  • 暗黙的: XML タイプ修飾子が XML 列に定義されている 場合。
  • 明示的: DSN_XMLVALIDATE 関数を使用する場合。

XML 列値を使用して、更新する行を指定できます。 XML 文書内の値を検索するには、XQuery 式を使用する必要があります。 XQuery 式を指定する方法の 1 つは XMLEXISTS 述部です。これにより XQuery 式を指定し、式の結果が空のシーケンスになるかどうかを判別することができます。XMLEXISTS が WHERE 文節内に指定されているとき、XQuery 式が空ではないシーケンスを戻すと、行が更新されます。

以下の例は、XML データを XML 列内で更新する方法を示しています。 この例では、サンプルの CUSTOMER 表のコピーである表 MYCUSTOMER を使用します。 この例は、1004 というカスタマー ID 値を持つ行が、既に MYCUSTOMER に含まれていることを前提としています。 既存の列データを更新する XML データはファイル c7.xml に入っており、次のようなものです。
<customerinfo xmlns="http://posample.org" Cid="1004">
<name>Christine Haas</name>
<addr country="Canada">
<street>12 Topgrove</street>
<city>Toronto</city>
<prov-state>Ontario</prov-state>
<pcode-zip>N9Y-8G9</pcode-zip>
</addr>
<phone type="work">905-555-5238</phone>
<phone type="home">416-555-2934</phone>
</customerinfo>
例: JDBC アプリケーションで、XML データをファイル c7.xml からバイナリー・データとして読み取り、それを使用して XML 列内のデータを更新します。
PreparedStatement updateStmt = null;
String sqls = null;
int cid = 1004;
sqls = "UPDATE Customer SET Info=? WHERE Cid=?";
updateStmt = conn.prepareStatement(sqls);
updateStmt.setInt(2, cid);
File file = new File("c7.xml");
updateStmt.setBinaryStream(1, new FileInputStream(file), (int)file.length());
updateStmt.executeUpdate();
例: 組み込み C アプリケーションで、XML AS BLOB ホスト変数を使用して XML 列内のデータを更新します。
EXEC SQL BEGIN DECLARE SECTION;
   sqlint64 cid;
   SQL TYPE IS XML AS BLOB (10K) xml_hostvar;
EXEC SQL END DECLARE SECTION;
…
cid=1004;
/* Read data from file c7.xml into xml_hostvar */
…
EXEC SQL UPDATE MYCUSTOMER SET xmlcol=:xml_hostvar WHERE Cid=:cid;
上記の例の場合、<customerinfo> エレメント内の Cid 属性の値が CID リレーショナル列にも保管されるようになっています。 そのため、UPDATE ステートメント内の WHERE 文節は、リレーショナル列 CID を使用して更新する行を指定します。 更新の対象として選択する行を決める値が XML 文書自体の中にしかない場合には、XMLEXISTS 述部を使用できます。例えば、前述の組み込み C アプリケーション例にある UPDATE ステートメントは、次のように変更して XMLEXISTS を使用するようにできます。
EXEC SQL UPDATE MYCUSTOMER SET xmlcol=:xml_hostvar
       WHERE XMLEXISTS ('declare default element namespace "http://posample.org";
                         /customerinfo[@Cid = $c]' 
                         passing INFO, cast(:cid as integer) as "c");