Articolo
09/28/2010

sp_help_notification (Transact-SQL)

Restituisce un elenco di avvisi per un determinato operatore o un elenco di operatori per un determinato avviso.

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

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