解決 DB2 代碼頁不相容 (SQL0332N / SQLSTATE 57017) 的單一指令方案

錯誤現象

db2 connect to <DB>
SQL0332N There is no available conversion for the source code page "819" to the target code page "1386". Reason Code "1". SQLSTATE=57017

用戶端代碼頁 (819 = ISO-8859-1) 與資料庫代碼頁 (1386 = 簡體中文 GBK) 無法直接轉換。

根因

DB2 要求用戶端與伺服器代碼頁**相容**。若用戶端環境未正確宣告代碼頁，DB2 會嘗試使用預設值 (常為 819)，導致與中文資料庫 (1386/1208/1252 等) 不相容。

解決指令 (在用戶端機器執行)

db2set DB2CODEPAGE=1386 -i <實例名>
db2 terminate

• DB2CODEPAGE 強制用戶端進程使用指定代碼頁
• -i <實例名> 針對特定實例生效 (省略則為全域)
• db2 terminate 斷開所有連線，使新設定生效

驗證

db2 connect to <DB> user <用戶> using <密碼>
# 應成功連線

補充說明

• 代碼頁對照常見值：1208 (UTF-8)、1386 (GBK)、1252 (Windows Latin-1)、819 (ISO-8859-1)
• 若資料庫為 Unicode (UTF-8)，用戶端建議設 1208
• 伺服器端代碼頁由 CREATE DATABASE 時指定，建立後**不可變更**
• 應用程式層 (JDBC/CLI/ODBC) 亦有對應屬性設定，需保持一致