Поделиться через

sp_update_operator (Transact-SQL)

  • Статья

Обновляет данные об операторе (получателе уведомлений) для организации оповещений и заданий.

Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии).

Значок ссылки на раздел Cинтаксические обозначения в Transact-SQL

Синтаксис

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' ]

Аргументы

  • [ @name=\] 'name'
    Имя оператора для изменения. Аргумент name имеет тип sysname и не имеет значения по умолчанию.

  • [ @new\_name=\] 'new_name'
    Новое имя оператора. Имя должно быть уникальным. Аргумент new_name имеет тип sysname и значение по умолчанию NULL.

  • [ @enabled=\] enabled
    Число, указывающее на текущее состояние оператора (1 — если в данный момент оператор включен, 0 — если не включен). Аргумент enabled имеет тип tinyint и значение по умолчанию NULL. Если оператор не включен, он не будет получать предупреждающих оповещений.

  • [ @email\_address=\] 'email_address'
    Адрес электронной почты оператора. Эта строка передается напрямую в систему электронной почты. Аргумент email_address имеет тип nvarchar(100) и значение по умолчанию NULL.

  • [ @pager\_address=\] 'pager_number'
    Адрес пейджера оператора. Эта строка передается напрямую в систему электронной почты. Аргумент pager_number имеет тип nvarchar(100) и значение по умолчанию NULL.

  • [ @weekday\_pager\_start\_time=\] weekday_pager_start_time
    Указывает время, по истечении которого на пейджер указанному оператору может быть отправлено оповещение (с понедельника по пятницу). Аргумент weekday_pager_start_timeимеет тип int, значение по умолчанию NULL, а остальные значения должны вводиться в формате ЧЧММСС в 24-часовых сутках.

  • [ @weekday\_pager\_end\_time=\] weekday_pager_end_time
    Указывает время, по истечении которого на пейджер указанному оператору не может быть отправлено оповещение (с понедельника по пятницу). Аргумент weekday_pager_end_timeимеет тип int, значение по умолчанию NULL, а остальные значения должны вводиться в формате ЧЧММСС в 24-часовых сутках.

  • [ @saturday\_pager\_start\_time=\] saturday_pager_start_time
    Указывает время, по истечении которого на пейджер указанному оператору может быть отправлено оповещение (по субботам). Аргумент saturday_pager_start_timeимеет тип int, значение по умолчанию NULL, а остальные значения должны вводиться в формате ЧЧММСС в 24-часовых сутках.

  • [ @saturday\_pager\_end\_time=\] saturday_pager_end_time
    Указывает время, по истечении которого на пейджер указанному оператору не может быть отправлено оповещение (по субботам). Аргумент saturday_pager_end_timeимеет тип int, значение по умолчанию NULL, а остальные значения должны вводиться в формате ЧЧММСС в 24-часовых сутках.

  • [ @sunday\_pager\_start\_time=\] sunday_pager_start_time
    Указывает время, по истечении которого на пейджер указанному оператору может быть отправлено оповещение (по воскресеньям). Аргумент sunday_pager_start_timeимеет тип int, значение по умолчанию NULL, а остальные значения должны вводиться в формате ЧЧММСС в 24-часовых сутках.

  • [ @sunday\_pager\_end\_time=\] sunday_pager_end_time
    Указывает время, по истечении которого на пейджер указанному оператору не может быть отправлено оповещение (по воскресеньям). Аргумент sunday_pager_end_timeимеет тип int, значение по умолчанию NULL, а остальные значения должны вводиться в формате ЧЧММСС в 24-часовых сутках.

  • [ @pager\_days=\] pager_days
    Указывает дни, в которые оператор доступен для приема сообщений на пейджер (с учетом времени начала и конца работы). Аргумент pager_daysимеет тип tinyint, значение по умолчанию NULL, а остальные значения — в диапазоне от 0 до 127. Аргумент pager_days рассчитывается путем сложения отдельных значений для требуемых дней. Например, периоду с понедельника по пятницу соответствует значение 2+4+8+16+32 = 62.

    Значение

    Описание

    1

    Воскресенье

    2

    Понедельник

    4

    Вторник

    8

    Среда

    16

    Четверг

    32

    Пятница

    64

    Суббота

  • [ @netsend\_address=\] 'netsend_address'
    Сетевой адрес оператора, которому посылается сетевое сообщение. Аргумент netsend_address имеет тип nvarchar(100) и значение по умолчанию NULL.

  • [ @category\_name=\] 'category'
    Имя категории предупреждения. Аргумент category имеет тип sysname и значение по умолчанию NULL.

Значения кода возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Хранимая процедура sp_update_operator должна запускаться из базы данных msdb.

Разрешения

По умолчанию разрешения на выполнение этой процедуры предоставляются членам предопределенной роли сервера sysadmin.

Примеры

В следующем примере состояние оператора изменяется на «включен» и назначается время (с понедельника по пятницу, с 8 до 17 часов), когда оператору можно передавать сообщения.

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

См. также

Справочник

sp_add_operator (Transact-SQL)

sp_delete_operator (Transact-SQL)

Хранимая процедура sp_help_operator (Transact-SQL)

Системные хранимые процедуры (Transact-SQL)