sp_help_category (Transact-SQL)

Articolo
08/21/2023

Si applica a:SQL Server

Restituisce informazioni sulle classi di processi, avvisi o operatori specificate.

Sintassi

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

Argomenti

[ @class = ] 'class' Classe relativa alle informazioni richieste. la classe è varchar(8), con un valore predefinito JOB. la classe può essere uno di questi valori.

Valore	Descrizione
LAVORO	Restituisce informazioni su una categoria di processi.
AVVISO	Restituisce informazioni su una categoria di avvisi.
OPERATORE	Restituisce informazioni su una categoria di operatori.

[ @type = ] 'type' Tipo di categoria per cui sono richieste le informazioni. il tipo è varchar(12), con un valore predefinito NULL e può essere uno di questi valori.

Valore	Descrizione
LOCAL	Categoria di processi locali.
MULTI-SERVER	Categoria di processi multiserver.
NONE	Categoria per una classe diversa da JOB.

[ @name = ] 'name' Nome della categoria per cui sono richieste le informazioni. name è sysname, con valore predefinito NULL.

[ @suffix = ] suffix Specifica se la colonna category_type nel set di risultati è un ID o un nome. il suffisso è bit, con un valore predefinito pari a 0. 1 mostra il category_type come nome e 0 lo mostra come ID.

Valori del codice restituito

0 (esito positivo) o 1 (errore)

Set di risultati

Quando @suffix è 0, sp_help_category restituisce il set di risultati seguente:

Nome colonna	Tipo di dati	Descrizione
category_id	int	Category ID
category_type	tinyint	Tipo di categoria: 1 = Locale 2 = Multiserver 3 = Nessuno
name	sysname	Nome categoria

Quando @suffix è 1, sp_help_category restituisce il set di risultati seguente:

Nome colonna	Tipo di dati	Descrizione
category_id	int	Category ID
category_type	sysname	Tipo di categoria: Uno di LOCAL, MULTI-SERVER o NONE
name	sysname	Nome categoria

Osservazioni:

sp_help_category deve essere eseguito dal database msdb.

Se non viene specificato alcun parametro, il set di risultati include informazioni su tutte le categorie dei processi.

Autorizzazioni

Per impostazione predefinita, questa stored procedure può essere eseguita dai membri del ruolo predefinito del server sysadmin . Gli altri utenti devono appartenere a uno dei seguenti ruoli predefiniti del database di SQL Server Agent nel database msdb:

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Per informazioni dettagliate sulle autorizzazioni di questi ruoli, vedere Ruoli di database predefiniti di SQL Server Agent.

Esempi

R. Restituzione di informazioni sui processi locali

Nell'esempio seguente vengono restituite informazioni sui processi gestiti a livello locale.

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

B. Restituzione di informazioni sugli avvisi

Nell'esempio seguente vengono restituite informazioni sulla categoria di avvisi Replication.

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

Vedi anche

sp_add_category (Transact-SQL)
sp_delete_category (Transact-SQL)
sp_update_category (Transact-SQL)
Stored procedure di sistema (Transact-SQL)