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

sp_add_operator (Transact-SQL)

  • Статья

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

Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии).

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

    Примечание

    В компоненте 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, которое соответствует 09: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)