使用 gMSA 疑難排解 SQL Server Agent 作業失敗

適用於: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 作業失敗問題

  1. 識別失敗的作業步驟子系統及工作歷史中第一個可操作的錯誤。
  2. 確認實際執行此步驟的身份是 SQL Server Agent 服務帳號,還是代理帳號。 如需詳細資訊,請參閱 建立 SQL Server Agent Proxy。
  3. 對於網路路徑和目的地資源,請確認 gMSA <DomainName>\<GmsaName>$ 在表單中已獲得共享與 NTFS 權限,並附上尾部的美元符號。 將 <GmsaName> 和 <DomainName> 替換為網域名稱和帳號名稱。
  4. 確認 gMSA 是否擁有目的地服務所需的權限,例如備份目標、連結伺服器或檔案分享。

預期結果: 執行身份對該工作步驟使用的每個資源都擁有明確權限。

解決 SQL Server Agent 工作失敗

使用與工作歷史中第一個可執行錯誤相符的解決方案。

授予執行身份目的資源權限

  1. 確認執行失敗作業步驟所使用的帳戶:

    • 一個沒有指定代理的 CmdExec 工作步驟會以 SQL Server Agent 服務帳號執行。
    • 指定 SQL Server Agent 代理的工作步驟會執行於代理憑證中儲存的 Windows 帳號下。
    • Transact-SQL 工作步驟不會使用 SQL Server Agent 代理。 它運行於工作主的安全脈絡中。 若工作擁有者是固定伺服器角色的成員sysadmin,該步驟會在 SQL Server Agent 服務帳號下執行,除非指定其他資料庫使用者。
  2. 授予執行身份所需的權限:

    • 若工作步驟以 SQL Server Agent 服務帳號執行,且該帳號為 gMSA,請指定 gMSA 電腦帳號形式的身份,包含尾隨的美元符號($)。 例如: CONTOSO\SQLAgentSvc$ 。
    • 如果工作步驟使用代理,請授予與代理憑證相關的 Windows 帳號權限,而非自動授予 SQL Server Agent 服務帳號或 gMSA。
    • 對於檔案分享,只需在 SMB 共享與底層 NTFS 資料夾上授予執行身份所需的權限。
  3. 為了驗證身份並取得共享存取權,請暫時在 CmdExec 工作步驟執行以下指令,該步驟使用與失敗步驟相同的 Run as Configuration 指令。

    whoami
    dir "\\FileServer\BackupShare"
    

    預期結果: 指令 whoami 回傳預期執行身份,並 dir 列出分享內容。

  4. 檢查後移除臨時診斷步驟。

修正 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 故障排除概述中的「收集診斷資料」。 利用這些資料繼續調查或開啟支援案件。