動態 SQL 字串拼接實戰：跨資料庫同步資料的 MERGE 模式

需將來源資料庫（客戶端）資料同步至目標資料庫（接口表），要求「已存在不重複導入、不存在則新增」。本文示範在 C# 中拼接 Oracle MERGE / INSERT WHEN NOT EXISTS 動態 SQL，並解決日期、數字、NULL 值拼接陷阱。

目標表結構

CREATE TABLE A (
  ID NUMBER(20),
  UPDATED_BY NUMBER(20),
  UPDATE_DATE DATE,
  UPDATE_LOGIN NUMBER(20),
  CREATION_DATE DATE,
  CREATED_BY NUMBER(20),
  NAME VARCHAR2(60),
  IMPORT_STATE VARCHAR2(1)
);

核心邏輯：INSERT WHEN NOT EXISTS + SELECT 1 FROM DUAL

INSERT WHEN (NOT EXISTS (SELECT 1 FROM A WHERE A.ID = :id))
THEN INTO A (ID, UPDATED_BY, CREATED_BY, UPDATE_DATE, UPDATE_LOGIN, CREATION_DATE, NAME, IMPORT_STATE)
VALUES (:id, :ub, :cb, TO_DATE(:ud, 'YYYY-MM-DD HH24:MI:SS'), :ul, TO_DATE(:cd, 'YYYY-MM-DD HH24:MI:SS'), :name, :state)
SELECT 1 FROM dual;

• WHEN NOT EXISTS 確保冪等性（重複執行不重複寫入）。
• SELECT 1 FROM dual 滿足 Oracle INSERT ... WHEN 語法要求的子查詢。

C# 動態拼接完整範例

foreach (DataRow dr in dsOra.Tables[0].Rows)
{
    string str = $@"
INSERT WHEN (NOT EXISTS (SELECT 1 FROM A WHERE A.ID = '{dr["ID"]}'))
THEN INTO A (ID, UPDATED_BY, CREATED_BY, UPDATE_DATE, UPDATE_LOGIN, CREATION_DATE, NAME, IMPORT_STATE)
VALUES (
  '{dr["ID"]}',
  '{dr["UPDATED_BY"]}',
  '{dr["CREATED_BY"]}',
  TO_DATE('{Convert.ToDateTime(dr["UPDATE_DATE"]):yyyy-MM-dd HH:mm:ss}', 'YYYY-MM-DD HH24:MI:SS'),
  '{dr["UPDATE_LOGIN"]}',
  TO_DATE('{Convert.ToDateTime(dr["CREATION_DATE"]):yyyy-MM-dd HH:mm:ss}', 'YYYY-MM-DD HH24:MI:SS'),
  '{dr["NAME"].ToString().Replace("'", "''")}',
  '{dr["IMPORT_STATE"]}'
)
SELECT 1 FROM dual;";

    sb.Append(str);
    sb.AppendLine(";");
}

拼接六步法（避免引號、逗號錯誤）

1. 寫好括號框架：VALUES ( )
2. 填入佔位逗號：VALUES ( , , , , , , , )
3. 加上單引號：VALUES ( '', '', '', '', '', '', '', '' )
4. 加上雙引號（字串拼接界限）：VALUES ( ''+'', ''+'', ... )
5. 加上變數與 + 號：VALUES ( '' + id + '', '' + ub + '', ... )
6. 移除首尾多餘逗號/加號，完成。

關鍵陷阱與對策

更優雅的替代方案

• MERGE 陳述式：Oracle 9i+ 支援，單條 SQL 完成 UPSERT，效能優於動態拼接。
• 參數化命令：OracleCommand.Parameters.Add 避免注入、自動處理型別轉換、計畫重用。
• 批次綁定：ArrayBindCount + 陣列參數，一次往返寫入成千上萬筆。