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")
Convenções da sintaxe Transact-SQL
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 padrão.[ @new\_name=\] 'new_name'
O novo nome do operador. Esse nome deve ser exclusivo. new_name é sysname, com o padrão de NULL.[ @enabled=\] enabled
Um número que indica o status atual do operador (1 se estiver habilitado atualmente, 0 se não estiver). enabled é tinyint, com o padrão de 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 para o sistema de email. email_address é nvarchar(100), com o padrão de NULL.[ @pager\_address=\] 'pager_number'
O endereço de pager do operador. Essa cadeia de caracteres é passada diretamente para o sistema de email. pager_number é nvarchar(100), com o padrão de 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 o padrão de 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 o padrão de 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 aos sábados. saturday_pager_start_timeé int, com o padrão de 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 aos sábados. saturday_pager_end_timeé int, com o padrão de 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 aos domingos. sunday_pager_start_timeé int, com o padrão de 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 aos domingos. sunday_pager_end_timeé int, com o padrão de 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 páginas (sujeitos aos horários de início/término especificados). pager_daysé tinyint, com o padrão de NULL, e seu valor deve ser de 0 a 127. pager_days é calculado com a adição de valores individuais para os dias necessários. Por exemplo, de segunda-feira a sexta-feira é 2+4+8+16+32 = 64.Value
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 para o qual a mensagem de rede é enviada. netsend_address é nvarchar(100), com um padrão NULL.[ @category\_name=\] 'category'
O nome da categoria para este alerta. category é sysname, com o padrão de NULL.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
sp_update_operator deve ser executado no banco de dados msdb.
Permissões
As permissões para executar esse procedimento para membros da função de servidor fixa sysadmin.
Exemplos
O exemplo a seguir atualiza o status do operador como habilitado e define os dias (de segunda-feira a sexta-feira, das 8h às 17h) 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 = 64 ;
GO
Consulte também
Referência
sp_add_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)