Compartilhar via


sp_update_operator (Transact-SQL)

Atualiza informações sobre um operador (recipiente de notificação) para ser usado com alertas e trabalhos.

Ícone de vínculo de tópicoConvenções de 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 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