sp_help_notification (Transact-SQL)
Aplica-se: SQL Server
Informa uma lista de alertas para determinado operador ou uma lista de operadores para um determinado alerta.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_help_notification
[ @object_type = ] 'object_type'
, [ @name = ] N'name'
, [ @enum_type = ] 'enum_type'
, [ @notification_method = ] notification_method
[ , [ @target_name = ] N'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 do operador fornecido, ou OPERATORS
, que lista os operadores responsáveis pelo nome do alerta fornecido.
[ @name = ] N'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'
O @object_type informações retornadas. @enum_type é ACTUAL
na maioria dos casos. @enum_type é char(10) e pode ser um desses valores.
Valor | Descrição |
---|---|
ACTUAL |
Lista apenas os @object_types associados a @name. |
ALL |
Lista todos os @object_types incluindo tipos que não estão associados a @name. |
TARGET |
Lista apenas os @object_types que correspondem ao @target_name fornecido, independentemente da associação com @name. |
@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 seguintes valores.
Valor | Descrição |
---|---|
1 |
E-mail: retorna apenas a use_email coluna. |
2 |
Pager: retorna apenas a use_pager coluna. |
4 |
NetSend: retorna apenas a use_netsend coluna. |
7 |
Tudo: retorna todas as colunas. |
@target_name [ = ] N'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 é sysname, com um padrão de NULL
. @target_name é necessário somente se @enum_type estiver definido como TARGET
.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Conjunto de resultados
Se @object_type for ALERTS
, o conjunto de resultados lista todos os alertas de 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 = Sim0 = Não |
use_pager |
int | Pager é usado para notificar o operador:1 = Sim0 = Não |
use_netsend |
int | Pop-up de rede é usado para notificar o operador:1 = Sim0 = 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 de envio de rede enviadas para este alerta. |
Se object_type
for OPERATORS
, o conjunto de resultados lista todos os operadores de 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 = Sim0 = Não |
use_pager |
int | O pager é usado para enviar uma notificação ao operador:1 = Sim0 = Não |
use_netsend |
int | É um pop-up de rede usado para notificar o operador:1 = Sim0 = Não |
has_email |
int | O operador tem um endereço de email:1 = Sim0 = Não |
has_pager |
int | O operador tem um endereço de pager:1 = Sim0 = Não |
has_netsend |
int | O operador tem uma notificação net send configurada.1 = Sim0 = Não |
Comentários
Esse procedimento armazenado deve ser executado no msdb
banco de dados.
Permissões
Para executar este procedimento armazenado, o usuário deve ser um membro da função de servidor fixa sysadmin .
Exemplos
R. Listar 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. Listar 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