sp_help_notification (Transact-SQL)

Artigo
12/11/2013

Status do tópico: algumas informações neste tópico são de pré-lançamento e estão sujeitas a mudanças em versões futuras. As informações de pré-lançamento descrevem novos recursos ou alterações em recursos existentes no Microsoft SQL Server 2014.

Informa uma lista de alertas para determinado operador ou uma lista de operadores para um determinado alerta.

Aplica-se a: SQL Server (SQL Server 2008 à versão atual).

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

sp_help_notification
     [ @object_type = ] 'object_type' ,
     [ @name = ] 'name' ,
     [ @enum_type = ] 'enum_type' , 
     [ @notification_method = ] notification_method 
     [ , [ @target_name = ] 'target_name' ]

Argumentos

[ @object_type =] 'object_type'
O tipo de informação a ser retornado. object_typeé char(9), sem padrão. object_type pode ser ALERTS, que lista os alertas atribuídos ao nome de operador fornecido*,* ou OPERATORS, que lista os operadores responsáveis pelo nome de alerta fornecido*.*
[ @name =] 'name'
Um nome de operador (se object_type for OPERATORS) ou um nome de alerta (se object_type for ALERTS). name é sysname, sem padrão.

[ @enum_type =] 'enum_type'
AS informações de object_typeretornadas. enum_type é ACTUAL na maioria dos casos. enum_typeé char(10), sem padrão, e pode ser um destes valores.

Value	Descrição
ACTUAL	Lista apenas os object_types associados a name.
ALL	Lista todos osobject_types incluindo aqueles que não estão associados a name.
TARGET	Lista apenas os object_types que correspondem ao target_namefornecido, independentemente da associação comname.

[ @notification_method =] notification_method
Um valor numérico que determina as colunas de método de notificação que devem ser retornadas. notification_method é tinyint e pode ser um dos valores a seguir.

Valor	Descrição
1	Email: retorna apenas a coluna use_email.
2	Pager: retorna apenas a coluna use_pager.
4	NetSend: retorna apenas a coluna use_netsend.
7	Tudo: retorna todas as colunas.

[ @target_name =] 'target_name'
Um nome de alerta a ser pesquisado (se object_type for ALERTS) ou um nome de operador a ser pesquisado (se object_type for OPERATORS). target_name é necessário apenas se enum_type for TARGET. target_name é sysname, com o padrão NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Se object_type for ALERTS, o conjunto de resultados listará todos os alertas para um determinado operador.

Nome da coluna	Tipo de dados	Descrição
alert_id	int	Número de identificador de alerta.
alert_name	sysname	Nome do alerta.
use_email	int	Email é usado para notificar o operador: 1 = Sim 0 = Não
use_pager	int	Pager é usado para notificar o operador: 1 = Sim 0 = Não
use_netsend	int	Pop-up de rede é usado para notificar o operador: 1 = Sim 0 = Não
has_email	int	Número de notificações de email enviadas para esse alerta.
has_pager	int	Número de notificações de pager enviadas para esse alerta.
has_netsend	int	Número de notificações net send enviadas para esse alerta.

Se object_type for OPERATORS, o conjunto de resultados listará todos os operadores para um determinado alerta.

Nome da coluna	Tipo de dados	Descrição
operator_id	int	Número de identificação do operador.
operator_name	sysname	Nome do operador.
use_email	int	O email é usado para enviar uma notificação ao operador: 1 = Sim 0 = Não
use_pager	int	O pager é usado para enviar uma notificação ao operador: 1 = Sim 0 = Não
use_netsend	int	É um pop-up de rede usado para notificar o operador: 1 = Sim 0 = Não
has_email	int	O operador tem um endereço de email: 1 = Sim 0 = Não
has_pager	int	O operador tem um endereço de pager: 1 = Sim 0 = Não
has_netsend	int	O operador tem uma notificação net send configurada. 1 = Sim 0 = Não

Comentários

Este procedimento armazenado deve ser executado a partir do banco de dados msdb.

Permissões

Para executar este procedimento armazenado, o usuário deve ser um membro da função de servidor fixa sysadmin.

Exemplos

A.Listando alertas para um operador específico

O exemplo a seguir retorna todos os alertas para os quais o operador François Ajenstat recebe qualquer tipo de notificação.

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.Listando operadores para um alerta específico

O exemplo a seguir retorna todos os operadores que recebem qualquer tipo de notificação para o alerta 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