sp_help_category (Transact-SQL)

Si applica a: sìSQL Server (tutte le versioni supportate)

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

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

[ @class = ] 'class' Classe su cui vengono richieste informazioni. la classe è di tipo varchar (8) e il valore predefinito è Job. la classe può essere uno di questi valori.

Valore Descrizione
PROCESSO 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 vengono richieste informazioni. il tipo è varchar (12) e il valore predefinito è null. i possibili valori sono i seguenti.

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 la quale vengono richieste informazioni. Name è di tipo sysname e il valore predefinito è null.

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

Valori del codice restituito

0 (esito positivo) o 1 (esito negativo)

Set di risultati

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

Nome colonna Tipo di dati Descrizione
category_id int ID della categoria
category_type tinyint Tipo di categoria:

1 = locale

2 = multiserver

3 = nessuna
nome sysname Nome della categoria

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

Nome colonna Tipo di dati Descrizione
category_id int ID della categoria
category_type sysname Tipo di categoria: Uno dei sistemi locali, multiserver o None
nome sysname Nome della categoria

Commenti

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 essere membri di uno dei ruoli predefiniti del database di SQL Server Agent seguenti 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  

Vedere anche

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