DB2 9 引入了帶註釋的 XML 模式分解功能,讓開發者能把整份 XML 文檔或其中片段分解到關聯表中。這個機制的核心,是在 XML Schema 中加入 DB2 專用註釋,用來描述 XML 元素或屬性應該對應到哪張表、哪個欄位。由於這些註釋不參與 XML 文檔本身的驗證,因此同一份 XML 模式仍然可以用來驗證文檔,也可以拿來定義分解映射。
這種設計讓 XML 資料不再只能整份存進 XML 欄位,也能依需求拆解成關聯資料,方便後續查詢、報表與既有系統整合。本文以 DB2 Visual Studio 2005 Add-in 為例,說明如何建立、註冊並測試帶註釋的 XML 模式,以及如何透過 .NET 程式碼呼叫分解程序。
實作前需要準備 Visual Studio .NET 2005 與 DB2 9。建議先安裝 Visual Studio .NET,再安裝 DB2 9,並確認 DB2 已啟用 TCP/IP。若安裝後不確定是否啟用,可以在 DB2 命令視窗中執行 db2set,檢查是否有 DB2COMM=tcpip。必要時,可透過 db2set、db2 update dbm cfg、db2stop 與 db2start 等命令完成設定。
建立 SAMPLE 資料庫時,務必選擇包含 XML 與 SQL 物件及資料的選項。完成後,可在 Visual Studio 的 Server Explorer 中連線到 SAMPLE 資料庫,並確認能看到 XML Schema Repository 節點。本文範例使用 SHIPTO 與 ITEM 兩張表,分別保存收件資訊與品項資料,並以一份 shiporder 格式的 XML 文檔作為分解來源。
在 Visual Studio 2005 中連線到 DB2 SAMPLE 資料庫後,於 XML Schema Repository 節點上按右鍵,選擇 Add Annotated XML Schema,即可開啟 DB2 Mapping Editor。接著選擇使用檔案中的 shiporder.xsd 作為來源,讓映射編輯器載入 XML 模式結構。

圖 1:建立帶註釋的 XML 模式。
載入來源後,映射編輯器會顯示 XML 模式的節點結構。此時可以選擇 Use document from file,並找到预先準備好的 shiporder.xsd。這一步的重點是讓 DB2 知道要根據哪一份 XML 模式來建立分解規則。

圖 2:選擇帶註釋的 XML 模式來源。
接著在 Mapping Editor 中按右鍵,選擇 Add Table,把 SHIPTO 與 ITEM 加入映射畫布。完成後,就可以把 XML 模式中的元素拖曳到目標表的欄位上。例如把 name 元素對應到 SHIPTO 表的 NAME 欄位,把 title、note、quantity、price 等元素對應到 ITEM 表的相關欄位。建立映射後,畫面上會出現連線,清楚表示元素與欄位之間的對應關係。

圖 3:帶註釋的 XML 模式映射編輯器。
映射完成後,按下 Visual Studio 的儲存按鈕,系統會跳出註冊 XML 模式的對話框。此時需要指定 XML 模式的名稱、目標資料庫與相關設定,再把帶註釋的 XML 模式儲存到 DB2 XML 模式庫中。註冊成功後,這份模式就能用於後續的分解與驗證。

圖 4:註冊帶註釋的 XML 模式。
註冊完成後,可以在 DB2 Mapping Editor 中按右鍵選擇 Test,挑選要測試的 XML 文檔,並決定是否在分解前先驗證 XML。若註釋與映射正確,測試會成功,且 SHIPTO 與 ITEM 表會出現對應資料。這個測試步骤能幫助開發者在寫程式之前,先確認映射邏輯是否正確。

圖 5:測試帶註釋的 XML 模式。
完成模式註冊後,就可以在 .NET 應用程式中呼叫 DB2 的 XML 分解程序。首先在 Visual Studio 中建立一個 Visual C# Windows Application 專案,然後加入 IBM.Data.DB2 參考。該元件通常位於 DB2 安裝目錄下的 SQLLIB 的 netf20 子目錄中,檔名為 IBM.Data.DB2.dll。
程式碼先建立 DB2Connection 並開啟資料庫連線,接著建立 DB2Command,將 CommandType 設為 StoredProcedure,並指定要呼叫的程序 SYSPROC.XDBDECOMPXML。這個程序會接收多個參數,包括註冊 XML 模式時使用的關聯模式或資料庫所有者、已註冊的 XML 模式名稱、要分解的 XML 文檔位元組內容、文件識別碼,以及是否要在分解前進行驗證的旗標。
由於 XML 文檔參數是二進位形式,程式中通常需要先把檔案讀成位元組陣列,再傳給 DB2Command。執行分解時,建議搭配交易控制,確保成功時提交、失敗時回滾。這樣即使 XML 內容或映射設定有誤,也不會留下部分寫入的資料。
帶註釋的 XML 模式分解,讓 DB2 能在保留 XML 文件結構的同時,把資料有選擇地放進關聯表。透過 DB2 Visual Studio 2005 Add-in,開發者可以用圖形化映射編輯器建立註釋、註冊模式並先行測試,大幅降低手工撰寫映射設定的門檻。再搭配 .NET 的 DB2 提供者與分解程序,就能把 XML 資料穩定地轉換為可用於既有關聯系統的結構化資料。