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

sp_update_operator (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 = 64.

    Значение Описание

    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 = 62 ;
GO

См. также

Справочник

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

Справка и поддержка

Получение помощи по SQL Server 2005