sp_add_category (Transact-SQL)

Artikel
2025-01-02

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

Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE , aber diese Berechtigungen können 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

Freigeben über