Partilhar via

sp_update_operator (Transact-SQL)

  • Artigo

Aplica-se a:SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_update_operator
    [ @name = ] N'name'
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @email_address = ] N'email_address' ]
    [ , [ @pager_address = ] N'pager_address' ]
    [ , [ @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 = ] N'netsend_address' ]
    [ , [ @category_name = ] N'category_name' ]
[ ; ]

Argumentos

@name [ = ] N'nome'

O nome do operador a ser modificado. @name é sysname, sem padrão.

@new_name [ = ] N'new_name'

O novo nome do operador. Esse nome deve ser exclusivo. @new_name é sysname, com um padrão de NULL.

@enabled [ = ] habilitado

Um número que indica o status atual do operador (1 se habilitado no momento, 0 se não). @enabled é minúsculo, com um padrão de NULL. Se não estiver habilitado, um operador não receberá notificações de alerta.

@email_address [ = ] N'email_address'

O endereço de email do operador. @email_address é nvarchar(100), com um padrão de NULL. Essa cadeia de caracteres é passada diretamente para o sistema de email.

@pager_address [ = ] N'pager_address'

O endereço de pager do operador. @pager_address é nvarchar(100), com um padrão de NULL. Essa cadeia de caracteres é passada diretamente para o sistema de email.

@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 de , e deve ser inserido no formulário HHmmss para uso com um relógio de NULL24 horas.

@weekday_pager_end_time [ = ] weekday_pager_end_time

Especifica o tempo após o qual uma notificação de pager não pode ser enviada ao operador especificado, de segunda a sexta-feira. @weekday_pager_end_time é int, com um padrão de , e deve ser inserido no formulário HHmmss para uso com um relógio de NULL24 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 um padrão de , e deve ser inserido no formulário HHmmss para uso com um relógio de NULL24 horas.

@saturday_pager_end_time [ = ] saturday_pager_end_time

Especifica o tempo após o qual uma notificação de pager não pode ser enviada ao operador especificado aos sábados. @saturday_pager_end_time é int, com um padrão de , e deve ser inserido no formulário HHmmss para uso com um relógio de NULL24 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 um padrão de , e deve ser inserido no formulário HHmmss para uso com um relógio de NULL24 horas.

@sunday_pager_end_time [ = ] sunday_pager_end_time

Especifica o tempo após o qual uma notificação de pager não pode ser enviada ao operador especificado aos domingos. @sunday_pager_end_time é int, com um padrão de , e deve ser inserido no formulário HHmmss para uso com um relógio de NULL24 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 é minúsculo, com um padrão de , e deve ser um valor de 0NULLaté 127. @pager_days é calculado somando-se os valores individuais para os dias necessários. Por exemplo, de segunda a sexta-feira é 264 = 32 + + + 16 + 48.

Valor Descrição
1 Sunday
2 Monday
4 Terça-feira
8 Quarta-feira
16 Quinta-feira
32 Friday
64 Sábado

@netsend_address [ = ] N'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 de NULL.

@category_name [ = ] N'category_name'

O nome da categoria para este alerta. @category_name é sysname, com um padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_update_operator deve ser executado a partir do msdb banco de dados.

Permissões

As permissões para executar esse procedimento usam como padrão membros da função de servidor fixa sysadmin .

Exemplos

O exemplo a seguir atualiza o status do operador, definindo @enabled como true, e define os dias (de segunda a sexta-feira, das 8h às 17h) em que o operador pode ser paginado.

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

Confira também