Delen via


sp_add_category (Transact-SQL)

Van toepassing op:SQL ServerAzure SQL Managed Instance

Voegt de gespecificeerde categorie taken, alerts of operators toe aan de server. Voor een alternatieve methode, zie Create a Job Category.

Transact-SQL syntaxis-conventies

Belangrijk

Op Azure SQL Managed Instanceworden de meeste, maar niet alle FUNCTIES van SQL Server Agent momenteel ondersteund. Zie de verschillen tussen Azure SQL Managed Instance T-SQL en SQL Server voor details.

Syntaxis

sp_add_category
     [ [ @class = ] 'class' ]
     [ , [ @type = ] 'type' ]
     [ , [ @name = ] 'name' ]
[ ; ]

Arguments

[ @class = ] 'klasse'

De klasse van de categorie die toegevoegd moet worden. @class is varchar(8) met een standaardwaarde van JOB, en kan een van deze waarden zijn.

Waarde Description
JOB Voegt een functiecategorie toe.
ALERT Voegt een waarschuwingscategorie toe.
OPERATOR Voegt een operatorcategorie toe.

[ @type = ] 'type'

Het type categorie dat toegevoegd moet worden. @type is varchar(12), met een standaardwaarde van LOCAL, en kan een van deze waarden zijn.

Waarde Description
LOCAL Een lokale functiecategorie.
MULTI-SERVER Een multiserver-functiecategorie.
NONE Een categorie voor een andere klasse dan JOB.

[ @name = ] 'naam'

De naam van de toe te voegen categorie. De naam moet uniek zijn binnen de gespecificeerde klasse. @name is een systeemnaam, zonder standaard.

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Resultaatset

Geen.

Opmerkingen

sp_add_category Moet vanuit de msdb database worden uitgevoerd.

Permissions

Je kunt rechten verlenen EXECUTE op deze procedure, maar deze rechten kunnen worden overschreven tijdens een SQL Server-upgrade.

Voorbeelden

Het volgende voorbeeld creƫert een lokale taakcategorie genaamd AdminJobs.

USE msdb;
GO

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