DB2 重導向還原失敗實戰排查：自動存儲環境下 SQL0104N 與 SQL1024N 錯誤解析

案例背景

在啟用自動存儲的 DB2 環境中嘗試異機重導向還原，執行腳本後連續報錯 SQL0104N（語法錯誤）與 SQL1024N（資料庫連線不存在），導致表空間容器重定義失敗。本文還原現場、分析根因、給出修正方案。

現場資訊

目標資料庫表空間佈局（來源庫）

關鍵點：Minimum recovery time = 2010-03-01-07.31.44，還原點需在此之後。

原始重導向腳本（含錯誤）

RESTORE DATABASE IESDB
FROM '/dbbackup'
DBPATH ON '/iesdb/IEs/NODE0000/SQL00001'
ON '/IEsdb/sprot' into sport
NEWLOGPATH '/IEsdb/sprot/DB2log/'
REPLACE EXISTING
REDIRECT
without rolling forward
WITHOUT PROMPTING;

SET TABLESPACE CONTAINERS FOR 0
USING ( file '/IEsdb/sprot/tbs0' 49152 );

SET TABLESPACE CONTAINERS FOR 2
USING ( file '/IEsdb/sprot/tbs2' 3932160 );

報錯輸出分析

SQL0104N  An unexpected token "ON" was found following "".
Expected tokens may include: "END-OF-STATEMENT". SQLSTATE=42601

SET TABLESPACE CONTAINERS FOR 0 USING ( file '/IEsdb/sprot/tbs0' 49152 )
SQL1024N  A database connection does not exist. SQLSTATE=08003

SET TABLESPACE CONTAINERS FOR 2 USING ( file '/IEsdb/sprot/tbs2' 3932160 )
SQL1024N  A database connection does not exist. SQLSTATE=08003

根因深度解析

錯誤 1：SQL0104N — RESTORE 語法錯誤

問題行：

DBPATH ON '/iesdb/IEs/NODE0000/SQL00001'
ON '/IEsdb/sprot' into sport

原因： DBPATH ON 子句僅支援單一路徑，語法為 DBPATH ON '/path'。腳本中出現兩個 ON 關鍵字，第二個 ON '/IEsdb/sprot' into sport 被解析器視為語法錯誤。

自動存儲限制： 啟用自動存儲的資料庫，不支援在 RESTORE 階段重新定義表空間容器。自動存儲意味著容器由 DB2 依據存儲路徑自動管理，SET TABLESPACE CONTAINERS 命令在重導向還原中會被忽略或報錯。

錯誤 2：SQL1024N — 連線不存在

原因： 由於第一條 RESTORE ... REDIRECT 語法失敗，重導向會話未成功建立，後續的 SET TABLESPACE CONTAINERS 命令無法在有效的重導向會話中執行，故報「資料庫連線不存在」。

修正方案

方案 A：若目標環境同樣啟用自動存儲（推薦）

僅指定資料庫級存儲路徑與日誌路徑，移除所有 SET TABLESPACE CONTAINERS 命令：

RESTORE DATABASE IESDB
FROM '/dbbackup'
DBPATH ON '/iesdb/IEs/NODE0000/SQL00001'
ON '/IEsdb/sprot'
NEWLOGPATH '/IEsdb/sprot/DB2log/'
REPLACE EXISTING
REDIRECT
WITHOUT ROLLING FORWARD
WITHOUT PROMPTING;

• DBPATH ON：指定資料庫目錄掛載點（自動存儲根路徑）。
• ON '/IEsdb/sprot'：指定自動存儲路徑（STOGROUP 路徑），DB2 將在該路徑下自動建立表空間容器。
• 執行後直接 RESTORE DATABASE IESDB CONTINUE。

方案 B：若目標環境需關閉自動存儲（DMS 手動管理）

1. 還原時不指定自動存儲路徑，改用傳統重導向語法。
2. 在 RESTORE ... REDIRECT 成功進入會話後，逐一執行 SET TABLESPACE CONTAINERS。
3. 注意：自動存儲資料庫備份無法直接還原為非自動存儲資料庫，需先在來源庫關閉自動存儲再備份，或使用 db2move/db2look+load 遷移。

通用修正腳本（自動存儲模式）

# 1. 進入重導向會話
db2 "RESTORE DATABASE IESDB FROM '/dbbackup' \
  DBPATH ON '/iesdb/IEs/NODE0000/SQL00001' \
  ON '/IEsdb/sprot' \
  NEWLOGPATH '/IEsdb/sprot/DB2log/' \
  REPLACE EXISTING REDIRECT WITHOUT ROLLING FORWARD WITHOUT PROMPTING"

# 2. 檢查會話狀態（應顯示重導向中）
db2 "LIST TABLESPACES"

# 3. 直接完成還原（無需 SET CONTAINERS）
db2 "RESTORE DATABASE IESDB CONTINUE"

# 4. 前滾日誌
db2 "ROLLFORWARD DATABASE IESDB TO END OF LOGS AND COMPLETE OVERFLOW LOG PATH ('/path/to/archived/logs')"

最佳實踐檢查清單

1. 確認自動存儲狀態： db2 get db cfg for | grep AUTO_STORAGE。來源與目標一致最省事。
2. 語法驗證： 先在測試庫用 db2 -tvf restore_script.sql 試跑，捕捉 SQL0104N 語法錯誤。
3. 路徑預建： DBPATH ON 與 ON 指定的目錄必須在實例擁有者權限下預先存在且可寫。
4. 日誌路徑： NEWLOGPATH 目錄需預建，前滾時若用 OVERFLOW LOG PATH 亦需掛載歸檔日誌。
5. Minimum Recovery Time： 還原點時間戳必須晚於此值，否則資料庫無法前滾至一致狀態。

總結

自動存儲簡化了容器管理，但也限制了重導向還原時的容器自定義能力。核心原則：自動存儲環境下重導向還原，僅重定向資料庫目錄與存儲路徑，勿嘗試 SET TABLESPACE CONTAINERS。 修正語法後，還原流程將順利推進，「水到渠成」。