Artikel
09/24/2010

sp_help_category (Transact-SQL)

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

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

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

Multiserver-Auftragskategorie

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.

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

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:

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)

Freigeben über