sp_add_category (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL Managed Instance

Fügt dem Server die angegebene Kategorie von Aufträgen, Warnungen oder Operatoren hinzu. Alternative Methode finden Sie unter Create Job Category using SQL Server Management Studio.

Transact-SQL-Syntaxkonventionen

Wichtig

In Azure SQL Managed Instance werden derzeit die meisten, aber nicht alle, SQL Server-Agent-Features unterstützt. Details dazu finden Sie unter T-SQL-Unterschiede zwischen Azure SQL Managed Instance und SQL Server.

Syntax

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

Argumente

[ @class = ] 'klasse'

Die Klasse der Kategorie, die hinzugefügt werden soll. @class ist varchar(8) mit einem Standardwert von JOB, und kann einer dieser Werte sein.

Wert Beschreibung
JOB Fügt eine Auftragskategorie hinzu
ALERT Fügt eine Warnungskategorie hinzu
OPERATOR Fügt eine Operatorkategorie hinzu

[ @type = ] 'type'

Der Typ der Kategorie, die hinzugefügt werden soll. @type ist varchar(12), mit einem Standardwert von LOCAL, und kann einer dieser Werte sein.

Wert Beschreibung
LOCAL Lokale Auftragskategorie
MULTI-SERVER Eine Mehrserverauftragskategorie.
NONE Eine Kategorie für eine andere Klasse als JOB.

[ @name = ] 'name'

Der Name der Kategorie, die hinzugefügt werden soll. Der Name muss innerhalb der angegebenen Klasse eindeutig sein. @name ist "sysname" ohne Standard.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler).

Resultset

Keine.

Hinweise

sp_add_category muss aus der msdb Datenbank ausgeführt werden.

Berechtigungen

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Beispiele

Im folgenden Beispiel wird die lokale Auftragskategorie AdminJobs erstellt.

USE msdb;
GO

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

Zugehöriger Inhalt