Transact-SQL 参考

sp_help_category

提供有关作业、警报或操作员的指定类的信息。

语法

sp_help_category [ [ @class = ] 'class' ]
    [ , [ @type = ] 'type' ]
    [ , [ @name = ] 'name' ]
    [ , [ @suffix = ] suffix ]

参数

[@class =] 'class'

有关所请求信息的类别。class 的数据类型为 varchar(8),默认值为 JOBclass 可以是下列值之一。

描述
JOB 提供有关作业分类的信息。
ALERT 提供有关警报分类的信息。
OPERATOR 提供有关操作员分类的信息。

[@type =] 'type'

是所请求信息的分类类型。type 的数据类型为 varchar(12),默认值为 NULL,可以是下列值之一。

描述
LOCAL 本地作业分类。
MULTI -SERVER 多服务器作业分类。
NONE JOB 类的分类。

[@name =] 'name'

是所请求信息的分类名称。name 的数据类型为 sysname,默认值为 NULL。

[@suffix =] suffix

指定结果集中的 category_type 列是 ID 还是名称。suffix 的数据类型为 bit,默认值为 0。如果是 1 则将 category_type 显示为名称,如果是 0 则将其显示为 ID。

返回代码值

0(成功)或 1(失败)

结果集
列名 数据类型 描述
category_id int 分类 ID
category_type tinyint 分类的类型:

1 = 本地
2 = 多服务器
3 = 无

name sysname 分类名

注释

必须在 msdb 数据库中执行 sp_help_category

如果未指定参数,则结果集提供有关所有作业分类的信息。

权限

执行权限默认授予 public 角色。任何可以执行该过程的用户都可以对下列内容进行创建、删除或更新操作:作业、作业步骤、作业分类、作业调度、作业服务器、任务或作业历史信息。

示例
A. 返回本地作业信息

下面的示例返回有关在本地管理的作业的信息。

USE msdb
EXEC sp_help_category @type = 'LOCAL'
B. 返回警报信息

下面的示例返回有关 Replication 警报分类的有关信息。

USE msdb
EXEC sp_help_category @class = 'ALERT', @name = 'Replication'

请参见

sp_add_category

sp_delete_category

sp_update_category

系统存储过程