sp_help_notification (Transact-SQL)

Articolo
06/18/2013

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 che si desidera ottenere. object_typeè di tipo char(9) e non prevede valori predefiniti. 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'
Le informazioni object_type restituite. enum_type è ACTUAL nella maggior parte dei casi. enum_typeè char(10) e non prevede valori predefiniti.

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
Un valore numerico che determina le colonne del metodo di notifica da restituire. notification_method è di tipo tinyint. I valori possibili 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'
Un nome dell'avviso da cercare (se object_type è ALERTS) un nome dell'operatore da cercare (se object_type è OPERATORS). target_name è necessario solamente se enum_type è 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