sp_add_operator (Transact-SQL)
Создает оператор (получатель уведомлений) для использования с предупреждениями и заданиями.
Синтаксис
sp_add_operator [ @name = ] 'name'
[ , [ @enabled = ] enabled ]
[ , [ @email_address = ] 'email_address' ]
[ , [ @pager_address = ] '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 = ] 'netsend_address' ]
[ , [ @category_name = ] 'category' ]
Аргументы
- [ @name= ] 'name'
Имя оператора (получателя уведомлений). Это имя должно быть уникальным и не может содержать символ процента (%). Аргумент name имеет тип sysname и не имеет значения по умолчанию.
- [ @enabled= ] enabled
Указывает текущее состояние оператора. Аргумент enabled имеет тип tinyint и значение по умолчанию 1 (активирован). Если задано значение 0, оператор не активирован и не получает уведомлений.
[ @email_address= ] 'email_address'
Адрес электронной почты оператора. Эта строка передается напрямую в систему электронной почты. Аргумент email_address имеет тип nvarchar(100) и значение по умолчанию NULL.В аргументе email_address можно указать физический адрес электронной почты или псевдоним. Например:
'jdoe' или 'jdoe@xyz.com'
- [ @pager_address= ] 'pager_address'
Адрес пейджера оператора. Эта строка передается напрямую в систему электронной почты. Аргумент pager_address имеет тип narchar(100) и значение по умолчанию NULL.
- [ @weekday_pager_start_time= ] weekday_pager_start_time
Время, после которого агент Microsoft SQL Server посылает уведомление на пейджер указанному оператору в рабочие дни с понедельника по пятницу. Аргумент weekday_pager_start_time имеет тип int и значение по умолчанию 090000, что соответствует 9:00 в 24-часовом формате, и должен быть задан в виде ЧЧММСС.
- [ @weekday_pager_end_time= ] weekday_pager_end_time
Время, после которого служба SQLServerAgent перестает посылать уведомления на пейджер указанному оператору в рабочие дни, с понедельника по пятницу. Аргумент weekday_pager_end_time имеет тип int и значение по умолчанию 180000, что соответствует 18:00 в 24-часовом формате, и должен быть задан в виде ЧЧММСС.
- [ @saturday_pager_start_time =] saturday_pager_start_time
Время, после которого служба SQLServerAgent посылает уведомление на пейджер указанному оператору по субботам. Аргумент saturday_pager_start_time имеет тип int и значение по умолчанию 090000, что соответствует 9:00 в 24-часовом формате, и должен быть задан в виде ЧЧММСС.
- [ @saturday_pager_end_time= ] saturday_pager_end_time
Время, после которого служба SQLServerAgent перестает посылать уведомления на пейджер указанному оператору по субботам. Аргумент saturday_pager_end_time имеет тип int и значение по умолчанию 180000, что соответствует 18:00 в 24-часовом формате, и должен быть задан в виде ЧЧММСС.
- [ @sunday_pager_start_time= ] sunday_pager_start_time
Время, после которого служба SQLServerAgent посылает уведомление на пейджер указанному оператору по воскресеньям. Аргумент sunday_pager_start_time имеет тип int и значение по умолчанию 090000, что соответствует 9:00 в 24-часовом формате, и должен быть задан в виде ЧЧММСС.
- [ @sunday_pager_end_time =] sunday_pager_end_time
Время, после которого служба SQLServerAgent перестает посылать уведомления на пейджер указанному оператору по воскресеньям. Аргумент sunday_pager_end_time имеет тип int и значение по умолчанию 180000, что соответствует 18:00 в 24-часовом формате, и должен быть задан в виде ЧЧММСС.
[ @pager_days= ] pager_days
Число, указывающее дни, когда оператор принимает пейджинговые сообщения (в соответствие с указанными начальными и конечными временами). Аргумент pager_days имеет тип tinyint и значение по умолчанию 0, что показывает, что оператор никогда не принимает пейджинговых сообщений. Корректные значения принадлежат диапазону от 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_add_operator должна выполняться из базы данных msdb.
Отправка сообщений на пейджер поддерживается системой электронной почты, в которой должна быть функция отправки пейджинговых сообщений через электронную почту.
Среда SQL Server Management Studio обеспечивает простой, наглядный способ управления заданиями и рекомендуется для подготовки и управления инфраструктурой заданий.
Разрешения
Только члены фиксированной серверной роли sysadmin могут выполнять процедуру sp_add_operator.
Примеры
В следующем примере задаются сведения об операторе для danwi. Оператор активен. Агент SQL Server посылает уведомления на пейджер с понедельника по пятницу с 8:00 до 17:00.
USE msdb ;
GO
EXEC dbo.sp_add_operator
@name = N'Dan Wilson',
@enabled = 1,
@email_address = N'danwi',
@pager_address = N'5551290AW@pager.Adventure-Works.com',
@weekday_pager_start_time = 080000,
@weekday_pager_end_time = 170000,
@pager_days = 62 ;
GO
См. также
Справочник
sp_delete_operator (Transact-SQL)
Хранимая процедура sp_help_operator (Transact-SQL)
sp_update_operator (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)