sp_help_category (Transact-SQL)

Gäller för:SQL Server

Tillhandahåller information om de specificerade klasserna av jobb, larm eller operatörer.

Transact-SQL syntaxkonventioner

Syntax

sp_help_category
    [ [ @class = ] 'class' ]
    [ , [ @type = ] 'type' ]
    [ , [ @name = ] N'name' ]
    [ , [ @suffix = ] suffix ]
[ ; ]

Arguments

[ @class = ] 'klass'

Specificerar vilken klass som efterfrågas information om. @class är varchar(8) och kan vara ett av dessa värden.

Värde Description
JOB (standardinställning) Ger information om en jobbkategori.
ALERT Ger information om en varningskategori.
OPERATOR Ger information om en operatorkategori.

[ @type = ] "typ"

Typen av kategori för vilken information efterfrågas. @type är varchar(12) och kan vara ett av dessa värden.

Värde Description
LOCAL Lokal jobbkategori.
MULTI-SERVER Multiserver-jobbkategori.
NONE Kategori för en annan klass än JOB.

[ @name = ] N'namn'

Namnet på kategorin för vilken information efterfrågas. @name är sysname, med standardvärdet .NULL

[ @suffix = ] suffix

Specificerar om kolumnen category_type i resultatuppsättningen är ett ID eller ett namn. @suffix är bit, med standardvärdet .0

  • 1 visar namnet category_type som ett namn.
  • 0 visar dem category_type som ett ID.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

När @suffix är 0, sp_help_category returnerar följande resultatmängd:

Kolumnnamn Datatyp Description
category_id int Kategori-ID
category_type tinyint Typ av kategori:

1 = Lokal
2 = Multiserver
3 = Ingen
name sysname Kategorinamn

När @suffix är 1, sp_help_category returnerar följande resultatmängd:

Kolumnnamn Datatyp Description
category_id int Kategori-ID
category_type sysname Typ av kategori. En av LOCAL, MULTI-SERVER, eller NONE
name sysname Kategorinamn

Anmärkningar

sp_help_category måste köras från databasen msdb .

Om inga parametrar anges ger resultatuppsättningen information om alla jobbkategorier.

Permissions

Du kan ge EXECUTE behörigheter för denna procedur, men dessa behörigheter kan åsidosättas vid en SQL Server-uppgradering.

Andra användare måste tilldelas en av följande SQL Server Agent-fasta databasroller i databasen msdb :

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

För detaljer om behörigheterna för dessa roller, se SQL Server Agent Fixed Database Roles.

Examples

A. Returnera lokal jobbinformation

Följande exempel ger information om jobb som administreras lokalt.

USE msdb;
GO

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

B. Information om återvändande

Följande exempel ger information om kategorin Replikationsvarning.

USE msdb;
GO

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