Partager via


sp_add_category (Transact-SQL)

S’applique à : SQL Server 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.

Conventions 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. @class est varchar(8) avec une valeur par défaut , JOBet 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. @type est varchar(12), avec une valeur par défaut , LOCALet peut être l’une de ces valeurs.

Valeur Description
LOCAL Catégorie de travaux locaux.
MULTI-SERVER Catégorie de travail multiserveur.
NONE Catégorie pour une classe autre que JOB.

[ @name = ] 'name'

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

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Jeu de résultats

Aucune.

Notes

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

autorisations

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

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