sp_help_category (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server

Stellt Informationen zu den angegebenen Klassen von Aufträgen, Warnungen oder Operatoren bereit.

Syntax

sp_help_category
    [ [ @class = ] 'class' ]
    [ , [ @type = ] 'type' ]
    [ , [ @name = ] N'name' ]
    [ , [ @suffix = ] suffix ]
[ ; ]

Argumente

[ @class = ] 'klasse'

Gibt die Klasse an, welche Informationen angefordert werden. @class ist varchar(8) und kann einer dieser Werte sein.

Wert	Beschreibung
`JOB` (Standardwert)	Stellt Informationen zu einer Auftragskategorie bereit.
`ALERT`	Stellt Informationen zu einer Warnungskategorie bereit.
`OPERATOR`	Stellt Informationen zu einer Operatorkategorie bereit.

[ @type = ] 'type'

Der Typ der Kategorie, für die Informationen angefordert werden. @type ist varchar(12) und kann einer dieser Werte sein.

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

[ @name = ] N'name'

Der Name der Kategorie, für die Informationen angefordert werden. @name ist "sysname" mit einem Standardwert von NULL.

[ @suffix = Suffix

Gibt an, ob die category_type Spalte im Resultset eine ID oder ein Name ist. @suffix ist bit, mit einem Standardwert von 0.

1 zeigt den category_type Namen an.
0 zeigt die category_type ID an.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Wenn @suffix ist, sp_help_category gibt 0das folgende Resultset zurück:

Spaltenname	Datentyp	BESCHREIBUNG
`category_id`	int	Kategorie-ID
`category_type`	tinyint	Kategorietyp: `1` = Lokal `2` = Multiserver `3` = Keine
`name`	sysname	Kategoriename

Wenn @suffix ist, sp_help_category gibt 1das folgende Resultset zurück:

Spaltenname	Datentyp	BESCHREIBUNG
`category_id`	int	Kategorie-ID
`category_type`	sysname	Art der Kategorie: Einer der folgenden Werte: `LOCAL`, `MULTI-SERVER` oder `NONE`
`name`	sysname	Kategoriename

Hinweise

sp_help_category muss aus der msdb Datenbank ausgeführt werden.

Werden keine Parameter angegeben, stellt das Resultset Informationen zu allen Auftragskategorien bereit.

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.

Anderen Benutzern muss eine der folgenden SQL Server-Agent festen Datenbankrollen in der msdb Datenbank gewährt werden:

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.

Beispiele

A. Lokale Auftragsinformationen zurückgeben

Im folgenden Beispiel werden Informationen zu Aufträgen zurückgegeben, die lokal verwaltet werden.

USE msdb;
GO

EXEC dbo.sp_help_category @type = N'LOCAL';
GO

B. Zurückgeben von Warnungsinformationen

Im folgenden Beispiel werden Informationen zur Warnungskategorie für die Replikation zurückgegeben.

USE msdb;
GO

EXEC dbo.sp_help_category
    @class = N'ALERT',
    @name = N'Replication';
GO

Freigeben über