sp_delete_jobsteplog (Transact-SQL)

适用于SQL Server Azure SQL 托管实例

删除使用参数指定的所有SQL Server 代理作业步骤日志。 使用此存储过程维护数据库中的 sysjobstepslogsmsdb

Transact-SQL 语法约定

语法

sp_delete_jobsteplog
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @step_name = ] N'step_name' ]
    [ , [ @older_than = ] older_than ]
    [ , [ @larger_than = ] larger_than ]
[ ; ]

参数

[ @job_id = ] 'job_id'

包含要删除的作业步骤日志的作业的标识号。 @job_id是 uniqueidentifier,默认值为 NULL.

必须指定@job_id@job_name,但不能指定这两者。

[ @job_name = ] N'job_name'

作业的名称。 @job_name为 sysname,默认值为 NULL.

必须指定@job_id@job_name,但不能指定这两者。

[ @step_id = ] step_id

要删除其作业步骤日志的作业中的步骤标识号。 @step_id为 int,默认值为 NULL. 如果未包含,则删除作业中的所有作业步骤日志,除非 指定了 @older_than或 @larger_than

可以指定@step_id@step_name,但不能指定两者。

[ @step_name = ] N'step_name'

将删除其作业步骤日志的作业中步骤的名称。 @step_name为 sysname,默认值为 NULL.

可以指定@step_id@step_name,但不能指定两者。

[ @older_than = ] older_than

要保留的最早的作业步骤日志的日期和时间。 @older_than为日期/时间,默认值为 NULL. 将删除早于该日期和时间的所有作业步骤日志。

可以指定@older_than@larger_than

[ @larger_than = ] larger_than

要保留的最大作业步骤日志的大小(字节)。 @larger_than为 int,默认值为 NULL. 大于此大小的所有作业步骤日志都会被删除。

可以指定@older_than@larger_than

返回代码值

0(成功)或 1(失败)。

结果集

无。

注解

sp_delete_jobsteplog 位于 msdb 数据库中。

如果未指定除指定@job_id@job_name以外的任何参数,则删除指定作业的所有作业步骤日志。

权限

此存储过程由 db_owner 角色拥有。 你可以为任何用户授予 EXECUTE 权限,但这些权限可能会在 SQL Server 升级期间被重写。

其他用户必须被授予数据库中以下SQL Server 代理固定数据库角色msdb之一:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

有关这些角色的权限的详细信息,请参阅 SQL Server 代理固定数据库角色

只有 sysadmin 的成员才能删除其他用户拥有的作业步骤日志。

示例

A. 从作业中删除所有作业步骤日志

以下示例删除作业 Weekly Sales Data Backup 的所有作业步骤日志。

USE msdb;
GO

EXEC dbo.sp_delete_jobsteplog
    @job_name = N'Weekly Sales Data Backup';
GO

B. 删除特定作业步骤的作业步骤日志

以下示例删除作业 Weekly Sales Data Backup 中步骤 2 的作业步骤日志。

USE msdb;
GO

EXEC dbo.sp_delete_jobsteplog
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 2;
GO

°C 根据年龄和大小删除所有作业步骤日志

以下示例从作业 Weekly Sales Data Backup 中删除时间早于 2005 年 10 月 25 日中午、大小大于 100 兆字节 (MB) 的所有作业步骤日志。

USE msdb;
GO

EXEC dbo.sp_delete_jobsteplog
    @job_name = N'Weekly Sales Data Backup',
    @older_than = '10/25/2005 12:00:00',
    @larger_than = 104857600;
GO