sp_help_category (Transact-SQL)

Sintaxis

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

Argumentos

• [ @class=] 'class'
  Es la clase sobre la que se solicita información. class es de tipo varchar(8) y su valor predeterminado es JOB. class puede tener los valores siguientes.

  Valor	Descripción
  JOB	Proporciona información acerca de una categoría de trabajo.
  ALERT	Proporciona información acerca de una categoría de alerta.
  OPERATOR	Proporciona información acerca de una categoría de operador.

• [ @type= ] 'type'
  Es el tipo de categoría cuya información se solicita. type es de tipo varchar(12), su valor predeterminado es NULL y puede tener los valores siguientes.

  Valor	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'
  Es el 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 category_type del conjunto de resultados es un Id. o un nombre. suffix es de tipo bit y su valor predeterminado es 0. 1 muestra category_type como nombre y 0 muestra esta opción como un Id.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Si @suffix es 0, sp_help_category devuelve el siguiente conjunto de resultados:

Si @suffix es 1, sp_help_category devuelve el siguiente conjunto de resultados:

Comentarios

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 de la función fija de servidor sysadmin pueden ejecutar este procedimiento almacenado. A otros usuarios debe concederse una de las siguientes funciones fijas de base de datos del Agente SQL Server en la base de datos msdb:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Para obtener más información acerca de los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.

Ejemplos

A. Devolver información de un trabajo local

USE msdb ;
GO

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

B. Devolver información de alertas

USE msdb ;
GO

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

Vea también

Referencia