sp_help_category (Transact-SQL)

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

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

• [ @class=] 'class'
  La clase sobre la que se solicita información. class es de tipo varchar(8) y su valor predeterminado es JOB. class puede tener uno de 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'
  Tipo de categoría cuya información se solicita. type es de tipo varchar(12), su valor predeterminado es NULL y puede tener uno de estos valores.

  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'
  Nombre de la categoría cuya información se solicita. name es de tipo sysname y su valor predeterminado es NULL.

• [ @suffix= ] suffix
  Especifica si la columna category_type en el conjunto de resultados es un identificador 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 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 obtener más información acerca de los permisos de estos roles, vea 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

Vea también

Referencia

sp_add_category (Transact-SQL)

sp_delete_category (Transact-SQL)

sp_update_category (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)