從 DB2 8.x 遷移 XML 應用至 DB2 Viper (V9) 完整指南

背景與動機

DB2 8.x 以關係基礎設施存儲 XML（CLOB 或分解到關係表）。DB2 9 (Viper) 引入原生 XML 支援：XML 作為獨立資料類型，以解析後的帶註解樹存儲，支援 XML 索引、XQuery、SQL/XML。遷移能釋放原生 XML 的查詢、索引、更新效能優勢。

系列文章規劃

1. 本文：基於 Java 的預存程序實現 XML 子文檔更新（下載原始碼/JAR）
2. 第二篇：8.x 與 Viper XML 特性對比、遷移影響分析、遷移腳本生成工具
3. 第三篇：分步遷移範例場景與原始碼

XMLUPDATE 預存程序：原生 XML 子文檔更新方案

因 XQuery 更新標準尚未定型，原生 XML 無開箱即用的部分更新功能。本預存程序在資料庫端完成修改，避免客戶端來回傳輸與 DOM 程式設計複雜度。

支援操作

• 修改任意文本/屬性節點值
• 替換元素節點（含子樹）
• 刪除節點
• 插入新元素
• 單次調用多文檔/多操作
• 動態 SQL 生成更新值、算術表達式計算
• 驗證更新後文檔（XML Schema）

注意：底層仍執行完整文檔寫入。

介面定義

commandXML 結構

• namespaces：路徑中使用的命名空間前綴映射（含預設命名空間）
• action=compute：value 為參數化表達式，? 代表原節點值
• using=sql：value 為 SQL 表達式，執行結果作為新值
• 路徑必須以 text() 結尾以處理空元素

部署步驟

1. 編譯 Java 原始碼產生 db2XMLfunctions.jar（或直接下載）
2. 設定 DB2_USE_DB2JCCT2_JROUTINE=on 啟用 JCC 驅動
3. CALL SQLJ.INSTALL_JAR('file:/path/db2XMLfunctions.jar', 'db2XMLfunctions', 0)
4. 註冊預存程序 CREATE PROCEDURE db2xmlfunctions.XMLUPDATE(...)（LANGUAGE JAVA, FENCED, PARAMETER STYLE JAVA）

使用範例

1. 建立測試表：CREATE TABLE XMLCustomer(cid INT PRIMARY KEY, info XML)
2. 插入範例 XML 文檔
3. 呼範例：
   • 替換節點：action="replace" + 完整元素內容
   • SQL 動態取值：using="sql" + 子查詢
   • 算術計算：action="compute" + (20+?)*32-?
   • 批次多操作：單一 updates 含多個 update
   • 更新後 Schema 驗證：updateSQL 中使用 XMLVALIDATE(? ACCORDING TO XMLSCHEMA ID ...)
   • 屬性/文本更新、追加子節點

遷移關鍵點提示

• 原生 XML 儲存格式變更，需重新載入資料（XMLPARSE）
• 應用層查詢改寫：XPath/XQuery 替代舊邏輯，利用 XML 索引
• 更新邏輯遷移至 XMLUPDATE 或 V9 新增的 XMLMODIFY（後續版本）
• 效能基線重測：原生 XML 通常大幅優於 CLOB/分解方案

結語

遷移至 DB2 Viper 原生 XML 是架構升級的關鍵步驟。XMLUPDATE 預存程序填補了 V9 初期部分更新的空白，配合遷移工具與分步驗證，可平滑過渡並釋放 XML 處理新能力。