sp_add_category (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 托管实例

将指定的作业、警报或操作员类别添加到服务器中。 有关替代方法，请参阅 使用 SQL Server Management Studio 创建作业类别。

Transact-SQL 语法约定

重要

Azure SQL 托管实例目前支持大多数（但不是所有）SQL Server 代理功能。 有关详细信息，请参阅 Azure SQL 托管实例与 SQL Server 的 T-SQL 区别。

语法

sp_add_category
     [ [ @class = ] 'class' ]
     [ , [ @type = ] 'type' ]
     [ , [ @name = ] 'name' ]
[ ; ]

参数

[ @class = ] 'class'

要添加的类别的类。 @class是 varchar（8），JOB默认值为 ，可以是其中一个值。

值 说明
JOB 添加作业类别。
ALERT 添加警报类别。
OPERATOR 添加操作员类别。

[ @type = ] 'type'

要添加的类别的类型。 @type是 varchar（12），默认值LOCAL为 ，可以是以下值之一。

值 说明
LOCAL 本地作业类别。
MULTI-SERVER 多服务器作业类别。
NONE 类的类别。JOB

[ @name = ] 'name'

要添加的类别的名称。 该名称在指定类中必须是唯一的。 @name为 sysname，无默认值。

返回代码值

0（成功）或 1（失败）。

结果集

无。

注解

sp_add_category 必须从 msdb 数据库运行。

权限

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

示例

以下示例将创建一个名为 AdminJobs 的本地作业类别。

USE msdb;
GO

EXEC dbo.sp_add_category
    @class = N'JOB',
    @type = N'LOCAL',
    @name = N'AdminJobs';
GO

相关内容