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


sp_add_operator (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

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

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

Синтаксис

sp_add_operator
    [ @name = ] '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 = ] 'category' ]
[ ; ]

Аргументы

[ = ] @name 'name'

Имя оператора (получателя уведомлений). Это имя должно быть уникальным и не может содержать символ процента (%). @name — sysname без значения по умолчанию.

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

Отображает текущее состояние оператора. @enabled имеет значение tinyint с значением по умолчанию 1 (включено). Если 0оператор не включен и не получает уведомления.

[ @email_address = ] N'email_address'

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

Можно указать физический адрес электронной почты или псевдоним для @email_address. Например:

fatmir.bregu или fatmir.bregu@contoso.com

Примечание.

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

[ @pager_address = ] N'pager_address'

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

[ @weekday_pager_start_time = ] weekday_pager_start_time

Время, после которого агент SQL Server отправляет уведомление пейджера указанному оператору в будние дни с понедельника по пятницу. @weekday_pager_start_time имеет значение int, по умолчанию 090000указывающее 9:00 A.M. в 24-часовом часовом режиме и должно быть введено с помощью формыHHmmss.

[ @weekday_pager_end_time = ] weekday_pager_end_time

Время, после которого служба агент SQL Server больше не отправляет уведомление пейджера указанному оператору по дням недели, с понедельника по пятницу. weekday_pager_end_time имеет значение int с значением по умолчанию180000, которое указывает на 6:00 вечера в 24-часовом часовом режиме и должно быть введено с помощью формыHHmmss.

[ @saturday_pager_start_time = ] saturday_pager_start_time

Время, после которого служба агент SQL Server отправляет уведомление пейджера указанному оператору в субботу. saturday_pager_start_time имеет значение int, в котором по умолчанию 090000указано значение 9:00 утра в 24-часовом часовом режиме и должно быть введено с помощью формыHHmmss.

[ @saturday_pager_end_time = ] saturday_pager_end_time

Время, после которого служба агент SQL Server больше не отправляет уведомление пейджера указанному оператору в субботу. @saturday_pager_end_time содержит значение по умолчанию180000, указывающее 6:00 вечера на 24-часовом часовом режиме и должно быть введено с помощью формыHHmmss.

[ @sunday_pager_start_time = ] sunday_pager_start_time

Время после того, как служба агент SQL Server отправляет уведомление пейджера указанному оператору в воскресенье. @sunday_pager_start_time имеет значение int с значением по умолчанию090000, которое указывает на 9:00 утра в 24-часовом часовом режиме и должно быть введено с помощью формыHHmmss.

[ @sunday_pager_end_time = ] sunday_pager_end_time

Время, после которого служба агент SQL Server больше не отправляет уведомление пейджера указанному оператору в воскресенье. @sunday_pager_end_time имеет значение int с значением по умолчанию180000, которое указывает на 6:00 вечера в 24 часах и должно быть введено с помощью формыHHmmss.

[ @pager_days = ] pager_days

Число, указывающее дни, которые оператор доступен для страниц (при условии указанного времени начала и окончания). @pager_days является крошечным, при этом по умолчанию 0 оператор недоступен для получения страницы. Допустимые значения находятся в 0 диапазоне 127от . @pager_days вычисляется путем добавления отдельных значений в течение необходимых дней. Например, с понедельника по пятницу 2 + 4 + 8 + 16 + 32 = 62. В следующей таблице перечислены значения для каждого дня недели.

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

[ @netsend_address = ] N'netsend_address'

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

[ = ] @category_name 'category'

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

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

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

Результирующий набор

Нет.

Замечания

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

Ваша система электронной почты должна иметь возможность электронной почты на страницы, если вы хотите использовать разбиение по страницам.

Среда SQL Server Management Studio обеспечивает простой и наглядный способ управления заданиями и рекомендуется для создания инфраструктуры заданий и управления ей.

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.

Примеры

В следующем примере задаются сведения об операторе для danwi. Оператор активен. агент SQL Server отправляет уведомления по пейджеру с понедельника по пятницу с 8 утра по 5 вечера.

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