sp_delete_jobsteplog (Transact-SQL)
删除用参数指定的所有 SQL Server 代理作业步骤日志。 使用此存储过程可在 msdb 数据库中维护 sysjobstepslogs 表。
适用范围：SQL Server（SQL Server 2008 到当前版本）。 |
.gif "主题链接图标")
语法
sp_delete_jobsteplog { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }
[ , [ @step_id = ] step_id | [ @step_name = ] 'step_name' ]
[ , [ @older_than = ] 'date' ]
[ , [ @larger_than = ] 'size_in_bytes' ]
参数
[ @job_id =] 'job_id'
包含要删除的作业步骤日志的作业的标识号。 job_id 的数据类型为 int，默认值为 NULL。[ @job_name =] 'job_name'
作业的名称。 job_name 的数据类型为 sysname，默认值为 NULL。备注
必须指定 job_id 或 job_name，但不能两个都指定。
[ @step_id =] step_id
要删除其作业步骤日志的作业中的步骤标识号。 如果未包括，则将删除作业中的所有作业步骤日志，除非指定了 @older_than 或 @larger_than。 step_id 的数据类型为 int，默认值为 NULL。[ @step_name =] 'step_name'
将删除其作业步骤日志的作业中步骤的名称。 step_name 的数据类型为 sysname，默认值为 NULL。备注
可以指定 step_id 或 step_name，但不能两个都指定。
[ @older_than =] 'date'
要保留的最早的作业步骤日志的日期和时间。 将删除早于该日期和时间的所有作业步骤日志。 date 的数据类型为 datetime，默认值为 NULL。 可以同时指定 @older_than 和 @larger_than。[ @larger_than =] 'size_in_bytes'
要保留的最大作业步骤日志的大小（字节）。 大于此大小的所有作业步骤日志都会被删除。 可以同时指定 @larger_than 和 @older_than。
返回代码值
0（成功）或 1（失败）
结果集
无
注释
sp_delete_jobsteplog 在 msdb 数据库中。
如果除 @job_id 或 @job_name 之外未指定任何参数，则将删除指定作业的所有作业步骤日志。
权限
默认情况下，只有 sysadmin 固定服务器角色的成员才可以执行此存储过程。 其他用户必须被授予 msdb 数据库中下列 SQL Server 代理固定数据库角色的权限之一：
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