Teilen über


sp_help_category (Transact-SQL)

Gilt für: SQL Server

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

Transact-SQL-Syntaxkonventionen

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

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.

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