SQL Agent 作業步驟類型選 **SSIS 套件** 或 **命令執行 `dtexec`** 時,失敗訊息僅顯示「以使用者 xxx 身分執行失敗」,無詳細錯誤,排查困難。
命令列執行 SSIS 套件 (`.dtsx` 或 SSISDB 目錄) 的標準工具,回傳詳細錯誤碼與輸出,適合 Agent 作業步驟 (CmdExec 類型) 或手工測試。
EXEC sp_configure 'show advanced options', 1; RECONFIGURE;
EXEC sp_configure 'xp_cmdshell', 1; RECONFIGURE;
安全警示:`xp_cmdshell` 極高風險,**生產環境建議關閉**,改用 **Agent CmdExec 步驟直接呼叫 `dtexec`** (由 Agent 服務帳號執行,不經 `xp_cmdshell`)。
-- Agent 步驟:類型 = Operating System (CmdExec)
dtexec /f "C:\SSIS\Packages\UpsertData.dtsx" /DECRYPT "YourPassword" /REPORTING EWCDI
| 錯誤現象 | 根因 | 解決 |
|---|---|---|
| 無法解密受保護節點 (0x8009000B) | ProtectionLevel = EncryptSensitiveWithUserKey,執行身分異於開發者 | 改用 `EncryptSensitiveWithPassword` + `/DECRYPT`,或部署至 SSISDB 選 Server Storage |
| 登入失敗 / 連線失敗 | Agent 服務帳號/Proxy 帳號無目標資料庫權限 | 建立 **Proxy 帳號** (Credentials + Proxy) 具備最低權限,步驟指定 Run As Proxy |
| 找不到檔案/路徑 | 路徑含空格未加引號、網路路徑無權限、32/64 位元不匹配 | 路徑加雙引號;用 UNC 路徑並給 Proxy 讀取權;確認呼叫正確版本 `dtexec` (x64: `C:\Program Files\Microsoft SQL Server\130\DTS\Binn\`) |
| 元件/連線管理員驗證失敗 | 執行時參數/環境變數未傳遞 | 使用 **環境** (Environment) 在 SSISDB 設定參數值,或 `/SET \Package.Variables[User::VarName];Value` 覆寫 |
| 記憶體不足 / 緩衝區錯誤 | 資料流緩衝區設定過大、並行度過高 | 調整 `DefaultBufferMaxSize`、`DefaultBufferMaxRows`、`EngineThreads`;啟用 64 位元執行 |
-- 在 SSIS 套件內加入「事件處理常式」OnError
-- 使用 Script Task 寫入自訂 Log 表或呼叫 sp_send_dbmail
-- 變數 System::ErrorCode, System::ErrorDescription 可取得完整錯誤