適用於:Windows 上的 SQL Server
Summary
本文將協助你排除在將 SQL Server Agent 服務帳號改為群組管理服務帳號(gMSA)後,開始出現的 SQL Server Agent 工作步驟失敗問題。 它涵蓋了 SQL Server Integration Services(SSIS)、維護計畫、備份、PowerShell 以及因新執行身份未具備所需共享權限、NTFS、代理權、憑證或套件權限而失敗的 CmdExec 工作步驟。
開始前,請先檢視前置條件,並執行 Troubleshoot SQL Server 設置、啟動及 gMSA 驗證失敗的快速驗證清單。
Symptoms
- SQL Server Agent 啟動了,但 SSIS、維護計畫、備份、PowerShell 或 CmdExec 的工作步驟都失敗了。
- 工作步驟在 SQL Server Agent 服務帳號改為 gMSA 後開始失敗。
- 錯誤則會識別缺少的元件、檔案、代理、憑證、分享或 NTFS 權限。
原因
在服務帳號變更後發生的工作步驟失敗,通常是新身份的存取問題,而非 gMSA 密碼管理問題。 未使用 Proxy 的工作步驟會以 SQL Server Agent 服務帳戶身分執行,因此請將先前帳戶所擁有的所有共用、NTFS 與目標權限授與 gMSA。
診斷 SQL Server Agent 作業失敗問題
- 識別失敗的作業步驟子系統及工作歷史中第一個可操作的錯誤。
- 確認實際執行此步驟的身份是 SQL Server Agent 服務帳號,還是代理帳號。 如需詳細資訊,請參閱 建立 SQL Server Agent Proxy。
- 對於網路路徑和目的地資源,請確認 gMSA
<DomainName>\<GmsaName>$在表單中已獲得共享與 NTFS 權限,並附上尾部的美元符號。 將<GmsaName>和<DomainName>替換為網域名稱和帳號名稱。 - 確認 gMSA 是否擁有目的地服務所需的權限,例如備份目標、連結伺服器或檔案分享。
預期結果: 執行身份對該工作步驟使用的每個資源都擁有明確權限。
解決 SQL Server Agent 工作失敗
使用與工作歷史中第一個可執行錯誤相符的解決方案。
授予執行身份目的資源權限
確認執行失敗作業步驟所使用的帳戶:
- 一個沒有指定代理的 CmdExec 工作步驟會以 SQL Server Agent 服務帳號執行。
- 指定 SQL Server Agent 代理的工作步驟會執行於代理憑證中儲存的 Windows 帳號下。
- Transact-SQL 工作步驟不會使用 SQL Server Agent 代理。 它運行於工作主的安全脈絡中。 若工作擁有者是固定伺服器角色的成員
sysadmin,該步驟會在 SQL Server Agent 服務帳號下執行,除非指定其他資料庫使用者。
授予執行身份所需的權限:
- 若工作步驟以 SQL Server Agent 服務帳號執行,且該帳號為 gMSA,請指定 gMSA 電腦帳號形式的身份,包含尾隨的美元符號(
$)。 例如:CONTOSO\SQLAgentSvc$。 - 如果工作步驟使用代理,請授予與代理憑證相關的 Windows 帳號權限,而非自動授予 SQL Server Agent 服務帳號或 gMSA。
- 對於檔案分享,只需在 SMB 共享與底層 NTFS 資料夾上授予執行身份所需的權限。
- 若工作步驟以 SQL Server Agent 服務帳號執行,且該帳號為 gMSA,請指定 gMSA 電腦帳號形式的身份,包含尾隨的美元符號(
為了驗證身份並取得共享存取權,請暫時在 CmdExec 工作步驟執行以下指令,該步驟使用與失敗步驟相同的 Run as Configuration 指令。
whoami dir "\\FileServer\BackupShare"預期結果: 指令
whoami回傳預期執行身份,並dir列出分享內容。檢查後移除臨時診斷步驟。
修正 SQL Server Agent 代理、憑證或工作步驟執行上下文
檢查失敗的作業步驟,並確認其子系統及 執行身分 設定。 對於支援代理的子系統,請建立或使用符合以下條件的代理:
- 參照所需 Windows 帳戶的認證。
- 已為工作步驟子系統啟用。
- 可供擁有或執行該工作的登入帳戶或 SQL Server Agent 角色使用。
- 使用一個擁有該工作步驟所需權限的帳號。
將代理分配到工作步驟。 建立代理並不會賦予帳號憑證中儲存的資源權限。 分別授予這些權限,並遵循最低權限原則。 如需詳細資訊,請參閱 建立 SQL Server Agent Proxy。
解決 SSIS 權限或套件存取錯誤
若 SSIS 工作步驟因權限或套件存取錯誤而失敗,請確認執行該 SSIS 工作步驟的帳號是否能存取以下資源:
- SSIS 套件位置。
- 設定檔和命令檔(如果有使用)。
- 套件參考的檔案與資料夾。
- 網路分享。
- 資料庫及其他資料來源。
- 套件所需的其他外部資源。
若套件使用由 SSIS ProtectionLevel 設定保護的敏感資訊,請確認執行帳號能解密所需資訊。 SQL Server Agent 執行帳號的變更可能導致 SSIS 套件失敗,因為新帳號無法解密套件祕密或沒有存取外部資源的權限。 更多資訊請參閱 SSIS 套件在從 SQL Server Agent 工作步驟呼叫時無法執行。
安裝或修理確認遺失的零件
僅安裝或修復已確認缺失的元件,並分別修正 SSIS 部署或執行時相容性,與帳號變更分開。 如果工作歷史中發現缺少元件,請確認該元件已安裝並可供執行身份使用,再更改權限。 範例包括:
- SSIS 元件。
- 工作所需的 PowerShell 模組。
- 由 CmdExec 工作步驟參考的自訂執行檔或腳本。
- 必須的提供者或其他執行時元件。
請將元件缺失或執行階段錯誤與權限錯誤分開排除。 元件安裝或修復後,再重新執行該工作。 如果還是失敗,請檢視工作歷史中第一個可操作的錯誤。
收集診斷資料
如果完成這些步驟後,工作步驟仍然失敗,請收集同一失敗期間的失敗工作歷史及其他診斷資料。 關於 gMSA 專屬證據及標準 SQL Server 日誌,請參閱 gMSA 故障排除概述中的「收集診斷資料」。 利用這些資料繼續調查或開啟支援案件。