sp_help_category (Transact-SQL)
Stellt Informationen zu den angegebenen Klassen von Aufträgen, Warnungen oder Operatoren bereit.
Syntax
sp_help_category [ [ @class = ] 'class' ]
[ , [ @type = ] 'type' ]
[ , [ @name = ] 'name' ]
[ , [ @suffix = ] suffix ]
Argumente
[ @class=] 'class'
Die Klasse, zu der Informationen angefordert werden. class hat den Datentyp varchar(8) und den Standardwert JOB. Für class ist einer der folgenden Werte möglich.Wert Beschreibung JOB
Stellt Informationen zu einer Auftragskategorie bereit.
ALERT
Stellt Informationen zu einer Warnungskategorie bereit.
OPERATOR
Stellt Informationen zu einer Operatorkategorie bereit.
[ @type= ] 'type'
Der Kategorientyp, für den Informationen angefordert werden. type hat den Datentyp varchar(12) und den Standardwert NULL. Die folgenden Werte sind möglich.Wert Beschreibung LOCAL
Lokale Auftragskategorie
MULTI-SERVER
Multiserverauftragskategorie
NONE
Die Kategorie für eine andere Klasse als JOB.
- [ @name= ] 'name'
Der Name der Kategorie, für die Informationen angefordert werden. name hat den Datentyp sysname und den Standardwert NULL.
- [ @suffix= ] suffix
Gibt an, ob es sich bei der Spalte category_type im Resultset um einen Bezeichner oder einen Namen handelt. suffix hat den Datentyp bit und den Standardwert 0. 1 gibt an, dass category_type ein Name ist, und 0 gibt an, dass es sich um einen Bezeichner handelt.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Resultsets
Wenn für @suffix der Wert 0 festgelegt ist, dann gibt sp_help_category das folgende Resultset zurück:
| Spaltenname | Datentyp | Beschreibung |
|---|---|---|
category_id |
int |
Kategorie-ID |
category_type |
tinyint |
Art der Kategorie: 1 = Lokal 2 = Multiserver 3 = Keine |
name |
sysname |
Kategoriename |
Wenn für @suffix der Wert 1 festgelegt ist, dann gibt sp_help_category das folgende Resultset zurück:
| Spaltenname | Datentyp | Beschreibung |
|---|---|---|
category_id |
int |
Kategorie-ID |
category_type |
sysname |
Art der Kategorie: entweder LOCAL, MULTI-SERVER oder NONE. |
name |
sysname |
Kategoriename |
Hinweise
sp_help_category muss aus der msdb-Datenbank heraus ausgeführt werden.
Werden keine Parameter angegeben, stellt das Resultset Informationen zu allen Auftragskategorien bereit.
Berechtigungen
Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Andere Benutzer müssen Mitglieder der festen SQL Server-Agent-Datenbankrollen in der msdb-Datenbank sein:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.
Beispiele
A. Zurückgeben von Informationen zu lokalen Aufträgen
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
Siehe auch
Verweis
sp_add_category (Transact-SQL)
sp_delete_category (Transact-SQL)
sp_update_category (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)