sp_add_operator (Transact-SQL)

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

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

Синтаксис

dbo.sp_add_operator
    [ @name = ] N'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 = ] N'category_name' ]
[ ; ]

Аргументы

[ @name = ] N'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 Agent отправляет оператору уведомления о пейджере, с понедельника по пятницу. @weekday_pager_start_time имеет значение int, по умолчанию 090000указывающее 9:00 A.M. в 24-часовом часовом режиме и должно быть введено с помощью формыHHmmss.

[ @weekday_pager_end_time = ] weekday_pager_end_time

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

[ @saturday_pager_start_time = ] saturday_pager_start_time

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

[ @saturday_pager_end_time = ] saturday_pager_end_time

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

[ @sunday_pager_start_time = ] sunday_pager_start_time

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

[ @sunday_pager_end_time = ] sunday_pager_end_time

Время окончания в воскресенье, когда служба SQL Server Agent больше не отправляет уведомления о пейджере оператору. @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 = ] N'category_name'

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

Если это значение равно NULL, оператор добавляется с категорией по умолчанию .[Uncategorized] Вы также можете выбрать из существующей категории, запросив таблицу syscategories в базе данных:msdb

SELECT name
FROM msdb.dbo.syscategories;

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

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

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

Нет.

Замечания

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

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

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

Разрешения

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

Примеры

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

USE msdb;
GO

EXECUTE 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

Обратная связь

Была ли эта страница полезна?

Last updated on 2025-12-03