sp_help_notification (Transact-SQL)
Restituisce un elenco di avvisi per un determinato operatore o un elenco di operatori per un determinato avviso.
Sintassi
sp_help_notification
[ @object_type = ] 'object_type' ,
[ @name = ] 'name' ,
[ @enum_type = ] 'enum_type' ,
[ @notification_method = ] notification_method
[ , [ @target_name = ] 'target_name' ]
Argomenti
[ @object_type =] 'object_type'
Tipo di informazioni da restituire. object_typeè di tipo char(9) e non prevede alcun valore predefinito. I possibili valori di object_type sono ALERTS, con cui vengono elencati gli avvisi assegnati al nome dell'operatore specificato*,* e OPERATORS, con cui vengono elencati gli operatori responsabili del nome di avviso specificato*.*[ @name =] 'name'
Nome di un operatore (se object_type è OPERATORS) o nome di un avviso (se object_type è ALERTS). name è di tipo sysname e non prevede alcun valore predefinito.[ @enum_type =] 'enum_type'
Informazioni su object_typerestituite. Nella maggior parte dei casi, enum_type è impostato su ACTUAL. enum_typeè di tipo char(10) e non prevede alcun valore predefinito. I possibili valori sono i seguenti.Valore
Descrizione
ACTUAL
Elenca solo gli object_types associati a name.
ALL
Elenca tutti gliobject_types, inclusi quelli non associati a name.
TARGET
Elenca solo gli object_types che corrispondono al target_name specificato, indipendentemente dall'associazione aname.
[ @notification_method =] notification_method
Valore numerico che determina le colonne da restituire relative al metodo di notifica. notification_method è di tipo tinyint e i possibili valori sono i seguenti.Valore
Descrizione
1
Posta elettronica: restituisce solo la colonna use_email.
2
Cercapersone: restituisce solo la colonna use_pager.
4
NetSend: restituisce solo la colonna use_netsend.
7
Tutto: restituisce tutte le colonne.
[ @target_name =] 'target_name'
Nome di un avviso da cercare (se object_type è impostato su ALERTS) oppure nome di un operatore da cercare (se object_type è impostato su OPERATORS). È necessario specificare target_name solo se enum_type è impostato su TARGET. target_name è di tipo sysname e il valore predefinito è NULL.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Set di risultati
Se object_type è impostato su ALERTS, il set di risultati include tutti gli avvisi per un determinato operatore.
Nome colonna |
Tipo di dati |
Descrizione |
---|---|---|
alert_id |
int |
Numero di identificazione dell'avviso. |
alert_name |
sysname |
Nome dell'avviso. |
use_email |
int |
Specifica se il metodo di notifica utilizzato è la posta elettronica: 1 = sì 0 = no |
use_pager |
int |
Specifica se il metodo di notifica utilizzato è il cercapersone: 1 = sì 0 = no |
use_netsend |
int |
Specifica se il metodo di notifica utilizzato è NetSend: 1 = sì 0 = no |
has_email |
int |
Numero di notifiche inviate tramite posta elettronica per l'avviso specificato. |
has_pager |
int |
Numero di notifiche inviate tramite cercapersone per l'avviso specificato. |
has_netsend |
int |
Numero di notifiche net send per l'avviso specificato. |
Se object_type è OPERATORS, il set di risultati include tutti gli operatori per un determinato avviso.
Nome colonna |
Tipo di dati |
Descrizione |
---|---|---|
operator_id |
int |
Numero di identificazione dell'operatore. |
operator_name |
sysname |
Nome dell'operatore. |
use_email |
int |
Specifica se il metodo di notifica utilizzato è la posta elettronica: 1 = sì 0 = no |
use_pager |
int |
Specifica se il metodo di notifica utilizzato è il cercapersone: 1 = sì 0 = no |
use_netsend |
int |
Specifica se il metodo di notifica utilizzato è NetSend: 1 = sì 0 = no |
has_email |
int |
Specifica se all'operatore è associato un indirizzo di posta elettronica: 1 = sì 0 = no |
has_pager |
int |
Specifica se all'operatore è associato un indirizzo cercapersone: 1 = sì 0 = no |
has_netsend |
int |
Specifica se per l'operatore è stata specificata la notifica tramite Net Send. 1 = sì 0 = no |
Osservazioni
Questa stored procedure deve essere eseguita nel database msdb.
Autorizzazioni
Per eseguire questa stored procedure, è necessario che gli utenti siano membri del ruolo predefinito del server sysadmin.
Esempi
A. Visualizzazione di un elenco di avvisi per un operatore specifico
Nell'esempio seguente vengono restituiti tutti gli avvisi per i quali François Ajenstat riceve una notifica.
USE msdb ;
GO
EXEC dbo.sp_help_notification
@object_type = N'ALERTS',
@name = N'François Ajenstat',
@enum_type = N'ACTUAL',
@notification_method = 7 ;
GO
B. Visualizzazione di un elenco di operatori per un avviso specifico
Nell'esempio seguente vengono restituiti tutti gli operatori che ricevono una notifica per l'avviso Test Alert.
USE msdb ;
GO
EXEC sp_help_notification
@object_type = N'OPERATORS',
@name = N'Test Alert',
@enum_type = N'ACTUAL',
@notification_method = 7 ;
GO