DB2 SQLSTATE 57016 原因碼 7 完整解析：REORG PENDING 狀態與修復指南

錯誤現象

對任意表操作 (SELECT/INSERT/UPDATE/DELETE) 皆報錯：

SQL0668N  Operation not allowed for reason code "7" on table XXX.
SQLSTATE=57016  SQLCODE=-668

根因追蹤

執行 db2 "? 57016" 可見官方定義：

SQLSTATE 57016：因表處於非作用狀態，無法存取。
原因碼 7：表處於 REORG PENDING (重組待決) 狀態。通常發生於執行 ALTER TABLE 包含 REORG 建議操作 (如變更欄位型態、新增 NOT NULL、資料分區變更) 之後，DB2 要求先重組才能繼續存取。

標準修復步驟

1. 確認狀態：

   db2 "SELECT TABSCHEMA, TABNAME, STATUS FROM SYSCAT.TABLES WHERE TABNAME='XXX'"

   STATUS = 'R' 即為 REORG PENDING。
2. 執行離線重組 (唯一解除方式)：

   db2 "REORG TABLE schema.XXX"

   注意：INPLACE REORG (線上重組) 不支援 解除 REORG PENDING 狀態。
3. 更新統計資訊 (建議)：

   db2 "RUNSTATS ON TABLE schema.XXX WITH DISTRIBUTION AND DETAILED INDEXES ALL"

4. 驗證：再次查詢表，錯誤應消失。

相關維護指令速查

單表維護標準流程範例

-- 1. 更新統計
db2 "RUNSTATS ON TABLE administrator.test"

-- 2. 離線重組 (解除 REORG PENDING)
db2 "REORG TABLE administrator.test"

-- 3. 重組後再次更新統計
db2 "RUNSTATS ON TABLE administrator.test WITH DISTRIBUTION AND DETAILED INDEXES ALL"

常見誤區

• ❌ 以為 REORG INDEX 即可解除 → 必須 REORG TABLE。
• ❌ 嘗試 INPLACE REORG → 此狀態下僅支援傳統離線重組。
• ❌ 忽略重組後 RUNSTATS → 導致優化器使用過時統計，產生劣質執行計畫。

預防建議

1. 變更結構前評估影響：db2look -d dbname -e -t tabname 檢視 DDL。
2. 維護窗口安排離線重組，避免業務高峰期觸發。
3. 啟用自動維護 (Auto Maintenance) 讓 DB2 自動偵測並排程重組 (需配置政策)。

掌握「偵測 → 離線重組 → 更新統計」三步驟，即可從容應對 57016/7 錯誤，確保資料庫持續可用。