DB2 遷移加速器：用存儲過程與 UDF 封裝 Oracle/Sybase/SQL Server 兼容函數

遷移痛點：方言差異三大類

• SQL 方言語法差異（如 TRUNCATE TABLE、HOST_NAME()）；
• 應用程序接口差異（JDBC/ODBC/CLI 行為細節）；
• 管理工具與運維命令差異。

解決方案：C 语言編寫外部例程 + SQL 註冊

利用 DB2 sqluimpr() API 封裝 IMPORT ... REPLACE INTO 實現 TRUNCATE_TABLE；解析 DBINFO 結構體中的應用 ID 提取客戶端 IP 反解主機名實現 HOST_NAME()；通過 UDF 調用存儲過程繞過「觸發器/函數中不能 CALL 過程」限制。

三大兼容例程詳解

1. TRUNCATE_TABLE( schema, table )

• 原理：調用 sqluimpr() 以 /dev/null (Windows NUL) 為空數據源執行 IMPORT ... REPLACE INTO，單次日誌記錄清空全表。
• 參數：schema 可為 NULL（取 CURRENT SCHEMA），支持雙引號定界標識符。
• 註冊：CREATE PROCEDURE TRUNCATE_TABLE ... LANGUAGE C EXTERNAL NAME 'functions!truncate_table' FENCED THREADSAFE

2. HOST_NAME() 返回客戶端主機名

• 原理：從 DBINFO 取應用 ID 前 8 字節解碼 IP（本地連接為 127.0.0.1），調用 gethostbyaddr() 反解。DRDA 協議下 IP 首字節 0-9 需映射回 G-P 再反解。
• 註冊：CREATE FUNCTION HOST_NAME() RETURNS VARCHAR(128) ... LANGUAGE C EXTERNAL NAME 'functions!host_name' DBINFO NOT FENCED

3. CALL_PROCEDURE( proc_name, params, db, user, pwd ) 從 UDF/觸發器調用存儲過程

• 原理：UDF 內部建立新連接，動態構造 CALL proc(params) 執行，返回 CLP 返回碼（0 成功）。
• 場景：觸發器中插入審計表、UDF 中調用外部業務邏輯過程。
• 註冊：CREATE FUNCTION CALL_PROCEDURE ... RETURNS INTEGER ... LANGUAGE C EXTERNAL NAME 'functions!call_procedure' THREADSAFE EXTERNAL ACTION

構建與部署流程

1. 源碼放入 sqllib/samples/c/functions.sqc；
2. 執行 bldrtn functions（Windows 需編輯 bldrtn.bat 鏈接 ws2_32.lib）；
3. 共享庫自動部署至 sqllib/function；
4. 執行 functions.db2 腳本註冊對象（終止符 @）：db2 -td@ -vf functions.db2。

驗證示例

-- TRUNCATE_TABLE
CALL TRUNCATE_TABLE('DB2INST1', 'TAB1');  -- 表瞬間清空

-- HOST_NAME
VALUES HOST_NAME();  -- 返回 'demoaix' 或 'mycomputer'

-- CALL_PROCEDURE 在觸發器中
CREATE TRIGGER INS AFTER INSERT ON T2
REFERENCING NEW AS N FOR EACH ROW
BEGIN ATOMIC
  VALUES CALL_PROCEDURE('DB2INST1.ABC', CHAR(N.COL1*2), 'SAMPLE', 'DB2INST1', 'db2inst1');
END;

適用版本與限制

• 支援 DB2 UDB V7、V8（含 Windows/Linux/Unix）。
• 外部 C 例程需目標平台 C 編譯器（Windows 建議 VS 6.0+，Linux gcc）。
• CALL_PROCEDURE 每次調用建立新連接，高頻場景需評估連接開銷。