sp_help_category (Transact-SQL)

Se aplica a: síSQL Server (todas las versiones admitidas)

Proporciona información acerca de las clases especificadas de trabajos, alertas u operadores.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

[ @class = ] 'class' Clase sobre la que se solicita información. la clase es VARCHAR (8) y su valor predeterminado es Job. la clase puede ser uno de estos valores.

Value Descripción
TRABAJO Proporciona información acerca de una categoría de trabajo.
ONALERT Proporciona información acerca de una categoría de alerta.
OPERATOR Proporciona información acerca de una categoría de operador.

[ @type = ] 'type' Tipo de categoría para la que se solicita información. Type es de tipo VARCHAR (12), su valor predeterminado es NULL y puede tener uno de estos valores.

Value Descripción
LOCAL Categoría de trabajo local.
MULTI -SERVER Categoría de trabajo multiservidor.
NONE Categoría para una clase distinta de Job.

[ @name = ] 'name' Nombre de la categoría para la que se solicita información. Name es de tipo sysname y su valor predeterminado es NULL.

[ @suffix = ] suffix Especifica si la columna de category_type del conjunto de resultados es un identificador o un nombre. el sufijo es de bit y su valor predeterminado es 0. 1 muestra el category_type como un nombre y 0 lo muestra como un identificador.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Cuando el @ sufijo es 0, sp_help_category devuelve el siguiente conjunto de resultados:

Nombre de la columna Tipo de datos Descripción
category_id int Id. de categoría
category_type tinyint Tipo de categoría:

1 = local

2 = multiservidor

3 = ninguno
name sysname Nombre de la categoría

Cuando el @ sufijo es 1, sp_help_category devuelve el siguiente conjunto de resultados:

Nombre de la columna Tipo de datos Descripción
category_id int Id. de categoría
category_type sysname Tipo de categoría. Uno de los locales, varios servidores o ninguno
name sysname Nombre de la categoría

Observaciones

sp_help_category se debe ejecutar desde la base de datos msdb .

Si no se especifica ningún parámetro, el conjunto de resultados proporciona información acerca de todas las categorías de trabajo.

Permisos

De forma predeterminada, los miembros del rol fijo de servidor sysadmin pueden ejecutar este procedimiento almacenado. Al resto de usuarios se les debe conceder uno de los siguientes roles fijos de base de datos del Agente SQL Server en la base de datos msdb :

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Para detalles sobre los permisos de estos roles, consulte Roles fijos de base de datos del Agente SQL Server.

Ejemplos

A. Devolver información de un trabajo local

Este ejemplo devuelve información acerca de los trabajos que se administran localmente.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_category  
    @type = N'LOCAL' ;  
GO  

B. Devolver información de alertas

Este ejemplo devuelve información acerca de la categoría de alertas de replicación.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_category  
    @class = N'ALERT',  
    @name = N'Replication' ;  
GO  

Consulte también

sp_add_category ()de Transact-SQL
sp_delete_category ()de Transact-SQL
sp_update_category ()de Transact-SQL
Procedimientos almacenados del sistema (Transact-SQL)