解決 DB2 SQL0443N 例程錯誤：SYSPRIMARYKEYS 綁定遺漏修復實錄

錯誤現場

[IBM][CLI Driver][DB2/6000] SQL0443N 例程 "SYSIBM.SQLPRIMARYKEYS"
（特定名稱 "PRIMARYKEYS"）返回了帶診斷文本
"SYSIBM:CLI:-805" 的錯誤 SQLSTATE。 SQLSTATE=38553
sqlcode: -443

錯誤碼解碼

• SQLSTATE 38553：IBM 內建例程（SYSIBM/SYSPROC 模式）錯誤，訊息文本含 SQLCODE（此處 -805）。
• SQLCODE -805：套件未找到或版本不匹配（Package not found），通常因 BIND 遺漏或版本升級後未重新綁定。

根因分析

Windows 環境安裝 FixPak 10 (V8.2 FP10) 後，系統目錄套件（如 db2schema.bnd）未自動重新綁定。CLI 內建存儲過程 SQLPRIMARYKEYS 依賴該套件，調用時找不到有效版本，拋出 -805 並包裝為 SQL0443N。

修復指令（經驗證有效）

db2 terminate
db2 connect to 
db2 bind /db2schema.bnd blocking all grant public sqlerror continue
db2 terminate

通常為 %DB2PATH%\bnd (Windows) 或 $DB2PATH/bnd (Linux/Unix)。

為何自動綁定失效？

• Windows 安裝程式邏輯缺陷：FP10 修補檔案但未觸發 db2bind 腳本。
• 手動應用修補包時跳過 db2iupdt -k 或未以實例擁有者身份執行綁定。
• 多實例環境僅更新主實例，從實例套件未同步。

預防清單

1. 修補包安裝後，對每個實例執行：
   db2iupdt -k <inst_name> → db2 bind <bnd_dir>/db2schema.bnd ... → db2 bind <bnd_dir>/db2cli.lst ...
2. 檢查 db2diag.log 是否有 SQL0805N 記錄，定期掃描。
3. 建立修補後驗證腳本：連線測試 CALL SYSPROC.SQLPRIMARYKEYS(...)、SQLTABLES 等 CLI 目錄過程。
4. 納入變更管理流程：修補包 = 重新綁定系統套件。

延伸：同類 -805 錯誤快速定位

-- 查詢無效套件
SELECT PKGNAME, PKGSCHEMA, VALID, LAST_BIND_TIME 
FROM SYSCAT.PACKAGES 
WHERE VALID = 'N';

-- 批次重新綁定（謹慎，建議維護窗口執行）
db2rbind <db_name> -l rebind.log all

結語

SQL0443N + SQLSTATE 38553 + 診斷文本含 -805，九成以上是系統套件綁定遺漏。養成「打補丁必重綁」習慣，可避免 90% 此類事故。