sp_add_operator

创建与警报和作业一起使用的操作员（提示接收者）。

语法

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 或 pager_addresss 为物理地址 ('SMTP:jdoe@xyz.com') 而不是别名 ('jdoe')，则该值必须包含在方括号内：'[SMTP:jdoe@xyz.com]'。

[@pager_address =] 'pager_address'

操作员的呼叫程序地址。该字符串直接传递到电子邮件系统。pager_addresss 的数据类型为 narchar(100)，默认设置为 NULL。

[@weekday_pager_start_time =] weekday_pager_start_time

Microsoft® SQL Server™ 代理程序在工作日（星期一到星期五）将呼叫提示发送给指定操作员之前的时间。weekday_pager_start_time 的数据类型为 int，默认设置为 090000，表示 24 小时制的上午 9:00，且必须使用 HHMMSS 的形式输入。

[@weekday_pager_end_time =] weekday_pager_end_time

SQLServerAgent 服务在工作日（星期一到星期五）不再将呼叫提示发送给指定操作员之前的时间。weekday_pager_end_time 的数据类型为 int，默认设置为 180000，表示 24 小时制的下午 6:00，且必须使用 HHMMSS 的形式输入。

[@saturday_pager_start_time =] saturday_pager_start_time

SQL Server 代理服务在星期六将呼叫提示发送给指定操作员之前的时间。saturday_pager_start_time 的数据类型为 int，默认设置为 090000，表示 24 小时制的上午 9:00，且必须使用 HHMMSS 的形式输入。

[@saturday_pager_end_time =] saturday_pager_end_time

SQLServerAgent 服务在星期六不再将呼叫提示发送给指定操作员之前的时间。saturday_pager_end_time 的数据类型为 int，默认设置为 180000，表示 24 小时制的下午 6:00，且必须使用 HHMMSS 的形式输入。

[@sunday_pager_start_time =] sunday_pager_start_time

SQLServerAgent 服务在星期天将呼叫提示发送给指定操作员之前的时间，sunday_pager_start_time 的数据类型为 int，默认设置为 090000，表示 24 小时制的上午 9:00，且必须使用 HHMMSS 的形式输入。

[@sunday_pager_end_time =] sunday_pager_end_time

SQLServerAgent 服务在星期天不再将呼叫提示发送给指定操作员之前的时间。sunday_pager_end_time 的数据类型为 int，默认设置为 180000，表示 24 小时制的下午 6:00，且必须使用 HHMMSS 的形式输入。

[@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（失败）

结果集

无

注释

必须从 msdb 数据库运行 sp_add_operator。

电子邮件系统支持呼叫，如果想使用呼叫，则该系统必须有电子邮件到呼叫程序的能力。

SQL Server 企业管理器提供易于使用的图形方法来管理作业，建议使用该方法创建和管理作业基本结构。

权限

只有 sysadmin 固定服务器角色的成员才可以执行 sp_add_operator。

示例

此示例设置 janetl 的操作员信息。启用操作员信息，这样，呼叫程序将从星期一到星期五的上午 8 点到下午 5 点通知 janetl。

use msdb
exec sp_add_operator @name = 'Janet Leverling',
   @enabled = 1,
   @email_address ='janetl',
   @pager_address = '5673219@mypagerco.com',
   @weekday_pager_start_time = 080000,
   @weekday_pager_end_time = 170000,
   @pager_days = 62

请参见