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


sp_update_operator (Transact-SQL)

Область применения: SQL Server

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

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

Аргументы

[ @name = ] N'name'

Имя оператора для изменения. @name — sysname без значения по умолчанию.

[ @new_name = ] N'new_name'

Новое имя оператора. Имя должно быть уникальным. @new_name — sysname с значением по умолчаниюNULL.

[ @enabled = ] включен

Номер, указывающий текущее состояние оператора (1 если в данный момент включен, 0 если нет). @enabled крошечный, с значением по умолчаниюNULL. Если это не включено, оператор не получает уведомления об оповещениях.

[ @email_address = ] N'email_address'

Адрес электронной почты оператора. @email_address — nvarchar(100) с значением по умолчаниюNULL. Эта строка передается напрямую в систему электронной почты.

[ @pager_address = ] N'pager_address'

Адрес пейджера оператора. @pager_address — nvarchar(100) с значением по умолчаниюNULL. Эта строка передается напрямую в систему электронной почты.

[ @weekday_pager_start_time = ] weekday_pager_start_time

Указывает время, по истечении которого на пейджер указанному оператору может быть отправлено оповещение (с понедельника по пятницу). @weekday_pager_start_time имеет значение int, по умолчанию NULLи должно быть введено в форму HHmmss для использования с 24-часовыми часами.

[ @weekday_pager_end_time = ] weekday_pager_end_time

Указывает время, после которого уведомление пейджера не может быть отправлено указанному оператору с понедельника по пятницу. @weekday_pager_end_time имеет значение int, по умолчанию NULLи должно быть введено в форме HHmmss для использования с 24-часовыми часами.

[ @saturday_pager_start_time = ] saturday_pager_start_time

Указывает время, по истечении которого на пейджер указанному оператору может быть отправлено оповещение (по субботам). @saturday_pager_start_time имеет значение int с значением по умолчанию NULLи должно быть введено в форме HHmmss для использования с 24-часовыми часами.

[ @saturday_pager_end_time = ] saturday_pager_end_time

Указывает время, после которого уведомление пейджера не может быть отправлено указанному оператору в субботу. @saturday_pager_end_time имеет значение int с значением по умолчанию NULLи должно быть введено в форме HHmmss для использования с 24-часовыми часами.

[ @sunday_pager_start_time = ] sunday_pager_start_time

Указывает время, по истечении которого на пейджер указанному оператору может быть отправлено оповещение (по воскресеньям). @sunday_pager_start_time имеет значение int с значением по умолчанию NULLи должно быть введено в форме HHmmss для использования с 24-часовыми часами.

[ @sunday_pager_end_time = ] sunday_pager_end_time

Указывает время, после которого уведомление пейджера не может быть отправлено указанному оператору в воскресенье. @sunday_pager_end_time имеет значение int с значением по умолчанию NULLи должно быть введено в форме HHmmss для использования с 24-часовыми часами.

[ @pager_days = ] pager_days

Указывает дни, в которые оператор доступен для приема сообщений на пейджер (с учетом времени начала и конца работы). @pager_days является крошечным, с значением по умолчанию NULLи должно быть значением от 0 до127. @pager_days вычисляется путем добавления отдельных значений в течение необходимых дней. Например, с понедельника по пятницу264 = 32 + + + 16 + 48.

значение Описание
1 Воскресенье
2 Понедельник
4 Вторник
8 Среда
16 Четверг
32 Пятница
64 Суббота

[ @netsend_address = ] N'netsend_address'

Сетевой адрес оператора, которому посылается сетевое сообщение. @netsend_address — nvarchar(100) с значением по умолчаниюNULL.

[ @category_name = ] N'category_name'

Имя категории предупреждения. @category_name — sysname с значением по умолчаниюNULL.

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

0 (успешно) или 1 (сбой).

Замечания

sp_update_operator должен выполняться из msdb базы данных.

Разрешения

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

Примеры

В следующем примере обновляется состояние оператора, значение @enabled trueпараметра и задает дни (с понедельника по пятницу с 8 утра по 5 вечера) при просмотре оператора.

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