Freigeben über


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.

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