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'

  Примечание
  Псевдоним электронной почты можно использовать только в службе SQL Mail. В компоненте Database Mail надо использовать адрес электронной почты.

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

• [ @weekday_pager_start_time= ] weekday_pager_start_time
  Время, после которого агент 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

См. также

Справочник