sp_add_category (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Lägger till den angivna kategorin av jobb, varningar eller operatörer till servern. För alternativ metod, se Skapa en jobbkategori.

Transact-SQL syntaxkonventioner

Viktigt!

Azure SQL Managed Instancestöds de flesta, men inte alla SQL Server Agent-funktioner för närvarande. Se Azure SQL Managed Instance T-SQL-skillnader från SQL Server för detaljer.

Syntax

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

Arguments

[ @class = ] 'klass'

Klassen i kategorin som ska läggas till @class är varchar(8) med ett standardvärde på JOB, och kan vara ett av dessa värden.

Värde Description
JOB Lägger till en jobbkategori.
ALERT Lägger till en varningskategori.
OPERATOR Lägger till en operatörskategori.

[ @type = ] "typ"

Vilken typ av kategori som ska läggas till. @type är varchar(12), med ett standardvärde på LOCAL, och kan vara ett av dessa värden.

Värde Description
LOCAL En lokal arbetskategori.
MULTI-SERVER En multiserver-jobbkategori.
NONE En kategori för en klass annan än JOB.

[ @name = ] 'namn'

Namnet på kategorin som ska läggas till. Namnet måste vara unikt inom den angivna klassen. @name är sysname, utan standard.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Ingen.

Anmärkningar

sp_add_category måste köras från databasen msdb .

Permissions

Du kan ge EXECUTE behörigheter för denna procedur, men dessa behörigheter kan åsidosättas vid en SQL Server-uppgradering.

Examples

Följande exempel skapar en lokal jobbkategori med namnet AdminJobs.

USE msdb;
GO

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