sp_update_operator (Transact-SQL)
Atualiza informações sobre um operador (recipiente de notificação) para ser usado com alertas e trabalhos.
.gif "Ícone de vínculo de tópico")
Sintaxe
sp_update_operator
[@name =] 'name'
[ , [@new_name =] 'new_name']
[ , [@enabled =] enabled]
[ , [@email_address =] 'email_address']
[ , [@pager_address =] 'pager_number']
[ , [@weekday_pager_start_time =] weekday_pager_start_time]
[ , [@weekday_pager_end_time =] weekday_pager_end_time]
[ , [@saturday_pager_start_time =] saturday_pager_start_time]
[ , [@saturday_pager_end_time =] saturday_pager_end_time]
[ , [@sunday_pager_start_time =] sunday_pager_start_time]
[ , [@sunday_pager_end_time =] sunday_pager_end_time]
[ , [@pager_days =] pager_days]
[ , [@netsend_address =] 'netsend_address']
[ , [@category_name =] 'category']
Argumentos
[ @name =] 'name'
O nome do operador a ser modificado. name é sysname, sem nenhum padrão.[ @new_name =] 'new_name'
O novo nome para o operador. Esse nome da deve ser exclusivo. new_name é sysname, com um padrão NULL.[ @enabled =] enabled
Um número indicando o status atual do operador (1 se estiver atualmente habilitado, 0 se não estiver). enabled é tinyint, com um padrão NULL. Se não estiver habilitado, um operador não receberá notificações de alerta.[ @email_address =] 'email_address'
O endereço de email do operador. Essa cadeia de caracteres é passada diretamente ao sistema de email. email_address é nvarchar(100), com um padrão NULL.[ @pager_address =] 'pager_number'
O endereço de pager do operador. Essa cadeia de caracteres é passada diretamente ao sistema de email. pager_number é nvarchar(100), com um padrão NULL.[ @weekday_pager_start_time =] weekday_pager_start_time
Especifica a hora depois da qual uma notificação de pager pode ser enviada a esse operador, de segunda-feira a sexta-feira. weekday_pager_start_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.[ @weekday_pager_end_time =] weekday_pager_end_time
Especifica a hora depois da qual uma notificação de pager não pode ser enviada ao operador especificado, de segunda-feira a sexta-feira. weekday_pager_end_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.[ @saturday_pager_start_time =] saturday_pager_start_time
Especifica a hora depois da qual uma notificação de pager pode ser enviada ao operador nos sábados. saturday_pager_start_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.[ @saturday_pager_end_time =] saturday_pager_end_time
Especifica a hora depois da qual uma notificação de pager não pode ser enviada ao operador nos sábados. saturday_pager_end_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.[ @sunday_pager_start_time =] sunday_pager_start_time
Especifica a hora depois da qual uma notificação de pager pode ser enviada ao operador nos domingos. sunday_pager_start_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.[ @sunday_pager_end_time =] sunday_pager_end_time
Especifica a hora depois da qual uma notificação de pager não pode ser enviada ao operador nos domingos. sunday_pager_end_timeé int, com um padrão NULL, e deve ser inserida no formato HHMMSS para uso com um relógio de 24 horas.[ @ pager_days =] pager_days
Especifica os dias em que o operador está disponível para receber notificações por pager (sujeitos aos horários de início/término especificados). pager_daysé tinyint, com um padrão NULL, e seu valor deve ser de 0 a 127. pager_days é calculado adicionando os valores individuais para os dias necessários. Por exemplo, de segunda-feira a sexta-feira é 2+4+8+16+32 = 64.Valor
Descrição
1
Domingo
2
Segunda-feira
4
Terça-feira
8
Quarta-feira
16
Quinta-feira
32
Sexta-feira
64
Sábado
[ @netsend_address =] 'netsend_address'
É o endereço de rede do operador ao qual a mensagem de rede é enviada. netsend_addressé nvarchar(100), com um padrão NULL.[ @category_name =] 'category'
O nome da categoria para esse alerta. category é sysname, com um padrão NULL.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
sp_update_operator deve ser executado a partir do banco de dados msdb.
Permissões
As permissões para executar este procedimento usam como padrão membros da função de servidor fixa sysadmin.
Exemplos
O exemplo a seguir atualiza o status do operador para habilitado e define os dias (de segunda-feira a sexta-feira, das 8:00 às 17:00) quando o operador pode ser notificado por pager.
USE msdb ;
GO
EXEC dbo.sp_update_operator
@name = N'François Ajenstat',
@enabled = 1,
@email_address = N'françoisa',
@pager_address = N'5551290AW@pager.Adventure-Works.com',
@weekday_pager_start_time = 080000,
@weekday_pager_end_time = 170000,
@pager_days = 62 ;
GO