sp_delete_jobsteplog (Transact-SQL)

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

主题链接图标 Transact-SQL 语法约定

语法

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_jobsteplogmsdb 数据库中。

如果除 @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

请参阅

参考

sp_help_jobsteplog (Transact-SQL)

SQL Server 代理存储过程 (Transact-SQL)