sp_help_category (Transact-SQL)

S’applique à : SQL Server (toutes les versions prises en charge)

Fournit des informations sur les classes de travaux, d'alertes ou d'opérateurs spécifiées.

Topic link iconConventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @class = ] 'class' Classe sur laquelle les informations sont demandées. la classe est varchar(8), avec une valeur par défaut de JOB. la classe peut être l’une de ces valeurs.

Valeur Description
Travail Fournit des informations sur une catégorie de travaux.
ALERTE Fournit des informations sur une catégorie d'alertes.
OPÉRATEUR Fournit des informations sur une catégorie d'opérateurs.

[ @type = ] 'type' Type de catégorie pour lequel les informations sont demandées. le type est varchar(12), avec une valeur null par défaut et peut être l’une de ces valeurs.

Valeur Description
LOCAL Catégorie de travaux locale.
MULTISERVER Catégorie de travaux multiserveur.
NONE Catégorie pour une classe autre que JOB.

[ @name = ] 'name' Nom de la catégorie pour laquelle des informations sont demandées. nomest sysname, avec une valeur par défaut null.

[ @suffix = ] suffix Spécifie si la colonne category_type du jeu de résultats est un ID ou un nom. suffixe est bit, avec une valeur par défaut de 0. 1 affiche le category_type en tant que nom, et 0 l’affiche comme ID.

Codet de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

Lorsque @suffix est 0, sp_help_category retourne le jeu de résultats suivant :

Nom de la colonne Type de données Description
category_id int ID de la catégorie
category_type tinyint Type de catégorie :

1 = Local

2 = Multiserveur

3 = Aucun
name sysname Nom de la catégorie

Lorsque @suffix est 1, sp_help_category retourne le jeu de résultats suivant :

Nom de la colonne Type de données Description
category_id int ID de la catégorie
category_type sysname Type de catégorie : Un des serveurs LOCAUX, MULTI-SERVER ou NONE
name sysname Nom de la catégorie

Remarques

sp_help_category doit être exécuté à partir de la base de données msdb .

Si aucun paramètre n'est spécifié, le jeu de résultats fournit des informations sur toutes les catégories de travaux.

Autorisations

Par défaut, les membres du rôle serveur fixe sysadmin peuvent exécuter cette procédure stockée. Les autres utilisateurs doivent disposer de l'un des rôles de base de données fixes suivants de SQL Server Agent dans la base de données msdb :

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Pour en savoir plus sur les autorisations de ces rôles, consultez Rôles de base de données fixes de l'Agent SQL Server.

Exemples

R. Renvoi d'informations sur les travaux en local

L'exemple suivant renvoie des informations sur les travaux qui sont administrés localement.

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

B. Renvoi d'informations sur les alertes

L'exemple suivant renvoie des informations sur la catégorie d'alerte de Replication.

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

Voir aussi

sp_add_category (Transact-SQL)
sp_delete_category (Transact-SQL)
sp_update_category (Transact-SQL)
Procédures stockées système (Transact-SQL)