sp_add_category (Transact-SQL)

  • Article

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

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) ou 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

Contenu connexe