Compartir a través de

sp_help_category (Transact-SQL)

  • Artículo

Se aplica a: SQL Server

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 = ] N'name' ]
    [ , [ @suffix = ] suffix ]
[ ; ]

Argumentos

[ @class = ] 'class'

Especifica la clase sobre qué información se solicita. @class es varchar(8) y puede ser uno de estos valores.

Valor Descripción
JOB (valor predeterminado) 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 varchar(12) y puede ser uno de estos valores.

Valor Descripción
LOCAL Categoría de trabajo local.
MULTI-SERVER Categoría de trabajo multiservidor.
NONE Categoría de una clase distinta de JOB.

[ @name = ] N'name'

Nombre de la categoría cuya información se solicita. @name es sysname, con un valor predeterminado de NULL.

[ @suffix = ] sufijo

Especifica si la category_type columna del conjunto de resultados es un identificador o un nombre. @suffix es bit, con un valor predeterminado de 0.

  • 1category_type muestra como un nombre.
  • 0category_type muestra como un identificador.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

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

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

1 = Local
2 = Multiservidor
3 = Ninguno
name sysname Nombre de la categoría

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

Nombre de la columna Tipo de datos Descripción
category_id int Identificador de categoría
category_type sysname Tipo de categoría. Uno de estos valores: LOCAL, MULTI-SERVER o NONE
name sysname Nombre de la categoría

Comentarios

sp_help_category debe ejecutarse desde la msdb base de datos.

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

Permisos

Puede conceder EXECUTE permisos en este procedimiento, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

A otros usuarios se les debe conceder uno de los siguientes Agente SQL Server roles fijos de base de datos en la msdb base de datos:

  • 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 del 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 alerta

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

Contenido relacionado