Oracle 移植 DB2 常見錯誤案例分析：PACKAGE 語法不相容與 CREATE OR REPLACE 陷阱

Oracle PL/SQL 移植至 DB2 SQL PL 時，封裝 (PACKAGE) 語法差異是高頻阻斷點。本文剖析一個真實的 CREATE OR REPLACE PACKAGE 移植失敗案例，解析 DB2 不支援 OR REPLACE、PACKAGE 規格/主體分離定義、參數模式關鍵字差異等核心問題，並給出修正後的 DB2 相容代碼。

原始 Oracle 代碼 (失敗案例)

CREATE OR REPLACE PACKAGE "CRM_PLOG"
AS
  PROCEDURE ETL_FO (
    IN i_crm_name VARCHAR,
    IN i_crm_type VARCHAR,
    IN i_crm_fo VARCHAR,
    IN i_crm_start TIMESTAMP,
    IN i_crm_end TIMESTAMP
  );
END CRM_PLOG;

DB2 報錯解析

SQL0104N 在 "CREATE PACKAGE" 後面找到異常標記 "CRM_PLOG"。預期標記可能包括: "JOIN"

根因：DB2 解析器不識別 CREATE OR REPLACE PACKAGE 這一 Oracle 專有語法，將 OR 誤認為 SQL 關鍵字，導致後續標記解析偏移。

核心語法差異對照

修正後的 DB2 相容代碼

步驟 1：建立 PACKAGE 規格 (介面定義)

CREATE PACKAGE CRM_PLOG
AS
  PROCEDURE ETL_FO (
    IN i_crm_name VARCHAR(128),
    IN i_crm_type VARCHAR(64),
    IN i_crm_fo VARCHAR(256),
    IN i_crm_start TIMESTAMP,
    IN i_crm_end TIMESTAMP
  );
END CRM_PLOG;

步驟 2：建立 PACKAGE BODY (實作邏輯)

CREATE PACKAGE BODY CRM_PLOG
AS
  PROCEDURE ETL_FO (
    IN i_crm_name VARCHAR(128),
    IN i_crm_type VARCHAR(64),
    IN i_crm_fo VARCHAR(256),
    IN i_crm_start TIMESTAMP,
    IN i_crm_end TIMESTAMP
  )
  LANGUAGE SQL
  BEGIN
    -- 具體 ETL 邏輯實作
    -- DECLARE 變數 ...
    -- INSERT/UPDATE/DELETE ...
    -- COMMIT;
  END;
END CRM_PLOG;

移植檢查清單 (Package 級)

1. 移除所有 OR REPLACE 關鍵字。
2. 拆分規格與主體為兩個 CREATE 語句。
3. 補全所有 VARCHAR、CHAR 長度。
4. 將 IN OUT 改為 INOUT。
5. 檢查 %TYPE、%ROWTYPE 引用是否支援 (DB2 部分支援)。
6. 游標、例外處理、動態 SQL (EXECUTE IMMEDIATE) 語法調整。
7. 授權：GRANT EXECUTE ON PACKAGE CRM_PLOG TO USER/ROLE。

工具輔助建議

• IBM Data Studio / Migration Toolkit：可自動轉換 70% 以上 PL/SQL → SQL PL 結構。
• 正則預處理：對大量檔案先做 s/CREATE OR REPLACE PACKAGE/CREATE PACKAGE/g 等批次替換。
• 編譯驗證：在 DB2 中逐個執行 CREATE PACKAGE，觀察 SQLSTATE 定位錯誤行。

Package 只是移植冰山一角，函數、觸發器、匿名區塊同理。建議建立「Oracle→DB2 語法對照表」納入團隊規範，移植前先跑工具掃描，人工修正剩餘 30% 複雜邏輯。