sp_help_category (Transact-SQL)

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:

Wenn für @suffix der Wert 1 festgelegt ist, dann gibt sp_help_category das folgende Resultset zurück:

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

USE msdb ;
GO

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

B. Zurückgeben von Warnungsinformationen

USE msdb ;
GO

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

Siehe auch

Verweis