sp_help_category (Transact-SQL)
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 su cui si desidera ottenere informazioni. class è di tipo varchar(8) e il valore predefinito è JOB. I possibili valori per class sono i seguenti.Valore Descrizione JOB
Restituisce informazioni su una categoria di processi.
ALERT
Restituisce informazioni su una categoria di avvisi.
OPERATOR
Restituisce informazioni su una categoria di operatori.
[ @type= ] 'type'
Tipo di categoria su cui vengono richieste informazioni. type è di 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 di una classe diversa da JOB.
- [ @name= ] 'name'
Nome della categoria su cui si desidera ottenere 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. suffix è di tipo bit e il valore predefinito è 0. 1 visualizza category_type come nome, mentre 0 lo visualizza come ID.
Set di risultati
Quando @suffix è 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 = Nessuno |
name |
sysname |
Nome della categoria |
Quando @suffix è 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: LOCAL, MULTI-SERVER o NONE |
name |
sysname |
Nome della categoria |
Osservazioni
La stored procedure sp_help_category deve essere eseguita 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 sulle autorizzazioni di questi ruoli, vedere Ruoli di database predefiniti di SQL Server Agent.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Esempi
A. Restituzione di informazioni sui processi locali
Nell'esempio seguente vengono restituite informazioni sui processi gestiti a livello locale.
USE msdb ;GOEXEC 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 ;GOEXEC dbo.sp_help_category @class = N'ALERT', @name = N'Replication' ;GO
Vedere anche
Riferimento
sp_add_category (Transact-SQL)
sp_delete_category (Transact-SQL)
sp_update_category (Transact-SQL)
Stored procedure di sistema (Transact-SQL)