在 DB2 SQL 存儲過程中使用 XML

在 COMMIT 或 ROLLBACK 之後的 XML 變量

XML 變量（包括參數和聲明的變量）在 COMMIT 或 ROLLBACK 之後不可用。如果試圖使用 XML 變量，而沒有首先給它們賦新值，就會產生下面這樣的錯誤：
清單 3. 在 COMMIT/ROLLBACK 之後收到的錯誤消息

SQL1354N　An　SQL　variable　in　routine　"XXX"　is　not　available　for　reference　due　
　to　a　recent　commit　or　rollback　Operation.　SQLSTATE=560CE　

如果需要在存儲過程中顯式地控制提交點，那麼考慮以下選項：

將變量的 XML 文檔傳遞進一個持久性的表中。使用 “持久性的” 表是因為聲明的全局臨時表當前不允許 XML 列。

將 XML 變量串行化成 VARCHAR，在 COMMIT 或 ROLLBACK 之後再解析它。

代碼示例

我們來研究一下如何在 DB2 存儲過程中處理 pureXML 數據。為此，我們將考慮幾個與常見編程場景相關的示例。

生成測試數據

盡管在開發期間可以從命令行測試存儲過程，但是可能需要創建虛構的 XML 文檔，它們將作為輸入參數發送。清單 4 提供一種生成測試數據的簡單技術：
清單 4. 生成測試數據（1）

CALL　ex_proc　
(　
　XMLPARSE(　
　　DOCUMENT　
　　'　
　　　<customer>　
　　　　<custid>HX25</custid>　
　　　</customer>　
　　'　
　)　
)　
;　

為了清晰，前一個示例保留了許多空白，使 XML 標記處於單獨的行上。但是，也可以讓代碼更緊湊：
清單 5. 生成測試數據（2）

CALL　ex_proc(XMLPARSE(DOCUMENT　'<customer><custid>HX25</custid></customer>'));　

聲明參數

新的 XML 數據類型可以作為參數傳遞進存儲過程中，可以采用任何模式（輸入、輸出或者同時作為輸入/輸出）。在聲明數據類型為 XML 時，不指定長度。與將 XML 數據作為 CLOB 或 VARCHAR 處理（這需要指定最大長度）相比，這是一項不錯的改進。
清單 6. 聲明參數

CREATE　PROCEDURE　process_cust　
(　
　IN　　　inpdoc　　XML,　
　OUT　　outdoc　　XML,　
　INOUT　doc3　　　XML　
)　
LANGUAGE　SQL　
NO　EXTERNAL　ACTION　
BEGIN　
　...　
END　

聲明變量

變量可以聲明為 XML 類型。與參數的情況一樣，不指定長度。
清單 7. 聲明變量

CREATE　PROCEDURE　ex_proc　
LANGUAGE　SQL　
NO　EXTERNAL　ACTION　
BEGIN　
　DECLARE　v_xml　　XML;　
　...　
END　

變量賦值

除了從游標獲得數據之外，可以使用三種不同的技術將來自單行查詢的值裝載進變量中：

SET 語句

SELECT INTO

VALUES INTO

這三種技術都可以使用 SQL/XML 函數，尤其是 XMLQUERY。本節中後面的示例分別演示這些技術。

下面的所有示例都使用同樣的輸入/輸出參數列表、同樣的輸入數據和同樣的 SQL/XML 函數，並產生同樣的結果。將三個參數傳遞給存儲過程。第一個參數是一個輸入 XML 文檔。第二個參數是一個輸出 VARCHAR。第三個參數是一個輸出 XML 文檔。

這些示例：

演示如何使用 XMLCAST，在將 XML 數據提取為標准關系數據類型（例如，CHAR 或 INT）時常常使用這種方法。

演示將 XMLQUERY 的輸出賦值給 XML 類型的變量。

在 XMLQUERY 函數中，“PASSING inpdoc” 引用變量。如果在 SELECT 語句中使用 XMLQUERY，那麼 PASSING 子句可以引用表列或者存儲過程變量。

在調用存儲過程的輸出中，可以看到提取 XML 元素與提取 XML 元素值之間的差異。

盡管這個示例只將值賦給輸出參數，但是使用聲明的變量也很容易。

清單 8. 三個變量賦值示例的輸入參數 “inpdoc” 的示例數據

<customer>　
　<name>Jed　Clampett</name>　
　<city>Beverly　Hills</city>　
</customer>　

清單 9. 三個變量賦值示例的輸出

Value　of　output　parameters　
--------------------------　
　
Parameter　Name　:　P2　
Parameter　Value　:　Jed　Clampett　
　
Parameter　Name　:　P3　
Parameter　Value　:　<name>Jed　Clampett</name>　
　
Return　Status　=　0　

變量賦值 / SET 語句

我們首先考慮如何將 XMLQuery 函數的輸出返回給存儲過程中聲明的變量。在這裡，p2 將輸出轉換為 VARCHAR 值，而 p3 以 XML 形式返回輸出。
清單 10. 使用 SET 語句進行變量賦值

CREATE　PROCEDURE　ex_proc　
(　
　IN　inpdoc　XML,　
　OUT　p2　　　VARCHAR(30),　
　OUT　p3　　　XML　
)　
LANGUAGE　SQL　
NO　EXTERNAL　ACTION　
BEGIN　
　
　SET　p2　=　
　　　　XMLCAST　
　　　　(　
　　　　　XMLQUERY('$d/customer/name'　PASSING　inpdoc　AS　"d")　
　　　　　AS　VARCHAR(30)　
　　　　);　
　
　SET　p3　=　XMLQUERY('$d/customer/name'PASSING　inpdoc　AS　"d");　
　
END