sp_add_category (Transact-SQL)

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

Ajoute la catégorie spécifiée de travaux, alertes ou opérateurs au serveur. Pour obtenir une autre méthode, consultez Créer une catégorie de travail à l’aide de SQL Server Management Studio.

Topic link iconConventions de la syntaxe Transact-SQL

Important

Dans Azure SQL Managed Instance, la plupart, mais pas toutes les fonctionnalités SQL Server Agent sont actuellement prises en charge. Pour plus d’informations, consultez Différences T-SQL entre Azure SQL Managed Instance et SQL Server.

Syntaxe

  
sp_add_category   
     [ [ @class = ] 'class', ]   
     [ [ @type = ] 'type', ]   
     { [ @name = ] 'name' }  

Arguments

[ @class = ] 'class' Classe de la catégorie à ajouter. la classe est varchar(8) avec une valeur par défaut de JOB et peut être l’une de ces valeurs.

Valeur Description
JOB Ajoute une catégorie de travail.
ALERT Ajoute une catégorie d'alertes.
OPERATOR Ajoute une catégorie d'opérateurs.

[ @type = ] 'type' Type de catégorie à ajouter. le type est varchar(12), avec une valeur par défaut de LOCAL et peut être l’une de ces valeurs.

Valeur Description
LOCAL Catégorie de travaux locaux.
MULTI-SERVER Catégorie de travail multiserveur.
Aucune Catégorie d’une classe autre que JOB**.**

[ @name = ] 'name' Nom de la catégorie à ajouter. Le nom doit être unique dans la classe spécifiée. nomest sysname, sans valeur par défaut.

Codet de retour

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

Jeux de résultats

None

Remarques

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

Autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_add_category.

Exemples

L'exemple suivant crée une catégorie de travail local nommée AdminJobs.

USE msdb ;  
GO  
  
EXEC dbo.sp_add_category  
    @class=N'JOB',  
    @type=N'LOCAL',  
    @name=N'AdminJobs' ;  
GO  

Voir aussi

sp_delete_category (Transact-SQL)
sp_help_category (Transact-SQL)
sp_update_category (Transact-SQL)
dbo.sysjobs (Transact-SQL)
dbo.sysjobservers (Transact-SQL)
Procédures stockées système (Transact-SQL)