PowerBuilder 動態 SQL 四種格式完整解析與應用場景

PowerBuilder 提供四種動態 SQL 格式，依「有無輸入參數」與「有無結果集」組合選用。

格式對照表

格式 1：EXECUTE IMMEDIATE

' 語法
EXECUTE IMMEDIATE SQLStatement {USING TransactionObject};

' 範例 1：建表
EXECUTE IMMEDIATE 'CREATE TABLE base(code CHAR(6), name CHAR(30))' USING SQLCA;

' 範例 2：變數 SQL
STRING ls_sql
ls_sql = "INSERT INTO base VALUES('320201', '市中區支行')"
EXECUTE IMMEDIATE :ls_sql USING SQLCA;

格式 2：PREPARE / EXECUTE

' 語法
PREPARE DynamicStagingArea FROM SQLStatement {USING TransactionObject};
EXECUTE DynamicStagingArea {USING ParameterList};

' 範例：參數化刪除
STRING ls_code = "320101"
PREPARE SQLSA FROM "DELETE FROM base WHERE code = ?";
EXECUTE SQLSA USING :ls_code;

SQLSA 為 PB 內建全域 DynamicStagingArea 變數。

格式 3：DECLARE CURSOR / PREPARE / OPEN / FETCH / CLOSE

' 語法
DECLARE cursor_name DYNAMIC CURSOR FOR DynamicStagingArea;
PREPARE DynamicStagingArea FROM SQLStatement {USING TransactionObject};
OPEN DYNAMIC cursor_name {USING ParameterList};
FETCH cursor_name INTO VariableList;
...
CLOSE cursor_name;

' 範例：查詢 code 中間兩碼為 '01' 的記錄
STRING ls_sql, ls_code, ls_name, ls_filter = "01"
ls_sql = "SELECT code, name FROM base WHERE SUBSTRING(code, 3, 2) = ?"

DECLARE cursor_base DYNAMIC CURSOR FOR SQLSA;
PREPARE SQLSA FROM :ls_sql;
OPEN DYNAMIC cursor_base USING :ls_filter;

FETCH cursor_base INTO :ls_code, :ls_name;
DO WHILE SQLCA.SQLCODE = 0
    ' 處理每列邏輯
    FETCH cursor_base INTO :ls_code, :ls_name;
LOOP
CLOSE cursor_base;

格式 4：完全動態 (DESCRIBE / 输入参数动态绑定)

' 適用：SELECT 清單、FROM 表名、WHERE 條件皆在執行期決定
' 需使用 DESCRIBE 動態描述結果集結構，配合 DynamicDescriptionArea
' 較複雜，僅在極度靈活需求 (如即時查詢工具) 時使用

最佳實踐建議

1. 優先用格式 2/3：參數化防注入、計畫重用、型別安全
2. 交易物件明確指定：USING SQLCA 或自訂 TransactionObject，避免隱含交易
3. 錯誤處理：每個動態 SQL 步驟後檢查 SQLCA.SQLCODE，SQLDBCode 針對資料庫錯誤碼
4. 游標關閉：務必 CLOSE，否則洩露資源導致連線耗盡
5. 避免格式 4**：除非必要，維護成本極高，易引入注入風險
6. 參數標記：PB 使用 ? 為佔位符，:var 綁定變數

常見錯誤與對策

動態 SQL 是雙面刃：靈活但危險。**參數化 (格式 2/3) + 嚴格錯誤處理 + 交易控制**是安全使用的關鍵。