Troubleshoot MSSQL job failures
Last updated on: 2020-09-21
Authored by: Karoline Mills
This article describes common reasons for SQL Server® job failures and basic troubleshooting steps to investigate them.
Common causes for job failures
SQL jobs can fail because of multiple reasons. To troubleshoot these failures, you can review the SQL Server Agent job history. To view these logs, perform the following steps:
-
Open SQL Server Management Studio (SSMS) and connect to the corresponding database instance.
-
Navigate to Management -> SQL Server Logs -> SQL job name.
-
Find the job failure event and review the log details.
The error logs should help you to determine if one or more steps of the job failed.
You can also configure jobs to export their logs to an external output file for detailed review by using the Advanced tab of the job’s properties.
You might see the following common reasons for SQL job failures:
Permission or authentication issues
The Windows® SQL Server Agent service must be available to perform SQL jobs. For example, if the user or service account that the service runs under has insufficient permissions to access network shares or file locations, job failures can happen. To verify this, perform the following steps:
-
Click on the Windows button in your taskbar and type Services.
-
Locate and right-click the SQL Server Agent service.
-
Review the account information in the Log On tab.
Similar to Windows services, SQL Agent Jobs run under a user or service account configured in the job. Job failures can occur when there are permission or authentication issues with the user or service account. Common issues include:
- Account expired
- Password incorrect
- Insufficient permissions to resources
- Account no longer exists
Review the job failure log details in SSMS to get more information about the specific error or permission issue. You can change the account under which the job is run by right-clicking the job. Navigate to the General tab and change the account under Run as:.
Unavailable system resources
Job failures can occur when certain resources are not available at the time of job execution. Examples for this include the following:
-
Insufficient disk space
-
High memory utilization
-
High CPU utilization
-
Network connectivity issues
Incorrect job configuration
Job failures can also occur if the job configuration is incorrect. To review the job configuration, right-click the job and select Properties. When you delete maintenance plans, the system does not automatically delete any included jobs, so you need to delete these jobs separately to avoid job failures. Additionally, the job configuration might point to system resources that no longer exist or an incorrect file or network path.