DB2 游標使用關鍵注意事項與最佳實踐

核心禁忌：游標區塊內嚴禁 COMMIT

在 DB2 游標迴圈中執行 COMMIT 會導致游標關閉，後續 FETCH 將拋出「游標未開啟」錯誤（SQLCODE -501）。游標宣告與操作必須在單一交易範圍內完成，或使用 WITH HOLD 選項跨交易保持游標（但需謹慎評估鎖持有影響）。

游標迴圈結束條件正確處理

使用 WHILE 迴圈遍歷游標時，必須宣告 NOT FOUND 條件處理器，否則游標讀至末尾後會陷入無限迴圈，重複回傳最後一筆資料。

標準範本

DECLARE v_notfound INT DEFAULT 0;

DECLARE c1 CURSOR FOR SELECT col1, col2 FROM table1;

DECLARE CONTINUE HANDLER FOR NOT FOUND
  SET v_notfound = 1;

OPEN c1;
SET v_notfound = 0;

FETCH c1 INTO v_col1, v_col2;
WHILE v_notfound = 0 DO
  -- 處理邏輯
  FETCH c1 INTO v_col1, v_col2;
END WHILE;

CLOSE c1;

CHAR 型別空白填充陷阱

DB2 CHAR(n) 型別擷取時會保留尾端空白至定義長度。直接比較或顯示會產生預期外結果。務必使用 TRIM() 或 RTRIM() 清理：

SET v_clean_val = TRIM(v_char_val);

游標呼叫存儲程序的錯誤傳播

若游標迴圈內呼叫的存儲程序發生錯誤（如邏輯錯誤、權限不足、資料異常），DB2 可能同樣回報「游標未開啟」而非原始錯誤碼。除錯建議：

• 獨立測試存儲程序確保邏輯正確。
• 在存儲程序內部妥善處理例外並回傳狀態碼，避免未處理例外中斷游標。
• 啟用應用層詳細日誌記錄實際錯誤堆疊。

綜合最佳實踐檢核表

掌握這些細節，能避開 90% 以上的 DB2 游標相關運行時錯誤，編寫健壯的 SQL PL 程式碼。