sp_add_category (Transact-SQL)
Gilt für: SQL Server Azure SQL Managed Instance
Fügt dem Server die angegebene Kategorie von Aufträgen, Warnungen oder Operatoren hinzu. Alternative Methode finden Sie unter Erstellen einer Auftragskategorie.
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
(erfolgreich) 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