Sdílet prostřednictvím


sp_help_category (Transact-SQL)

platí pro:SQL Server

Poskytuje informace o specifikovaných třídách pracovních pozic, upozorněních nebo operátorů.

Transact-SQL konvence syntaxe

Syntaxe

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

Arguments

[ @class = ] 'třída'

Specifikuje třídu, o které jsou informace požadovány. @class je varchar(8) a může být jednou z těchto hodnot.

Hodnota Description
JOB (výchozí) Poskytuje informace o kategorii práce.
ALERT Poskytuje informace o kategorii upozornění.
OPERATOR Poskytuje informace o kategorii operátorů.

[ @type = ] 'typ'

Typ kategorie, pro kterou jsou informace požadovány. @type je varchar(12) a může být jednou z těchto hodnot.

Hodnota Description
LOCAL Místní pracovní pozice.
MULTI-SERVER Kategorie práce pro více serverů.
NONE Kategorie pro třídu jinou než JOB.

[ @name = ] N'jméno'

Název kategorie, pro kterou jsou informace požadovány. @name je sysname s výchozím nastavením NULL.

[ @suffix = ] přípona

Specifikuje, zda je sloupec category_type ve výsledné množině ID nebo název. @suffix je bit, s výchozím hodnotou 0.

  • 1 ukazuje jméno the category_type jako jméno.
  • 0 ukazuje to category_type jako ID.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Když je @suffix , 0sp_help_category vrací následující množinu výsledků:

Název sloupce Datový typ Description
category_id int ID kategorie
category_type tinyint Typ kategorie:

1 = Místní
2 = Multiserver
3 = Žádná
name sysname Název kategorie

Když je @suffix , 1sp_help_category vrací následující množinu výsledků:

Název sloupce Datový typ Description
category_id int ID kategorie
category_type sysname Typ kategorie. Jeden z LOCAL, MULTI-SERVERnebo NONE
name sysname Název kategorie

Poznámky

sp_help_category musí být spuštěna z databáze msdb .

Pokud nejsou specifikovány žádné parametry, výsledná množina poskytuje informace o všech kategoriích úloh.

Povolení

Na tomto postupu můžete udělit EXECUTE oprávnění, ale tato oprávnění mohou být během upgradu SQL Serveru přepsána.

Ostatní uživatelé musí mít v databázi msdb přiděleny některé z následujících pevných databázových rolí SQL Server Agent:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Podrobnosti o oprávněních těchto rolí naleznete v SQL Server Agent Fixed Database Roles.

Examples

A. Vraťte místní pracovní informace

Následující příklad vrací informace o pracovních pozicích, které jsou spravovány lokálně.

USE msdb;
GO

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

B. Informace o návratu varování

Následující příklad vrací informace o kategorii upozornění na replikaci.

USE msdb;
GO

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