sp_add_operator (Transact-SQL)

Создает оператор (получатель уведомлений) для использования с предупреждениями и заданиями.

Значок ссылки на разделСоглашения о синтаксическом обозначении в 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