sp_help_operator (Transact-SQL)

适用范围:SQL Server

报告有关为服务器定义的操作员的信息。

Transact-SQL 语法约定

语法

sp_help_operator
    [ [ @operator_name = ] N'operator_name' ]
    [ , [ @operator_id = ] operator_id ]
[ ; ]

参数

[ @operator_name = ] N'operator_name'

运算符名称。 @operator_name为 sysname,默认值为 NULL. 如果未 指定@operator_name ,则返回有关所有运算符的信息。

必须指定@operator_id@operator_name,但不能指定这两者。

[ @operator_id = ] operator_id

为其请求信息的操作员的标识号。 @operator_id为 int,默认值为 NULL.

必须指定@operator_id@operator_name,但不能指定这两者。

返回代码值

0(成功)或 1(失败)。

结果集

列名称 数据类型 描述
id int 操作员标识号。
name sysname 运算符名称。
enabled tinyint 操作员可以接收到任何通知:

1 = 是
0 = 否
email_address nvarchar(100) 操作员电子邮件地址。
last_email_date int 上次用电子邮件通知操作员的日期。
last_email_time int 上一次用电子邮件通知操作员的时间。
pager_address nvarchar(100) 操作员寻呼地址。
last_pager_date int 上一次通过寻呼通知操作员的日期。
last_pager_time int 上一次通过寻呼通知操作员的时间。
weekday_pager_start_time int 某一时间段的起始时间,在工作日的该时间段内操作员可以接收到寻呼通知。
weekday_pager_end_time int 某一时间段的结束时间,在工作日的该时间段内操作员可以接收到寻呼通知。
saturday_pager_start_time int 某一时间段的起始时间,在星期六的该时间段内操作员可以接收到寻呼通知。
saturday_pager_end_time int 某一时间段的结束时间,在星期六的该时间段内操作员可以接收到寻呼通知。
sunday_pager_start_time int 某一时间段的起始时间,在星期日的该时间段内操作员可以接收到寻呼通知。
sunday_pager_end_time int 某一时间段的结束时间,在星期日的该时间段内操作员可以接收到寻呼通知。
pager_days tinyint 一个位掩码(1 = 星期日, 64 = 星期六),指示操作员何时可以接收寻呼通知。
netsend_address nvarchar(100) 接收网络弹出通知的操作员地址。
last_netsend_date int 上一次用网络弹出消息通知操作员的日期。
last_netsend_time int 上一次用网络弹出消息通知操作员的时间。
category_name sysname 该操作员所属的操作员分类的名称。

注解

sp_help_operator 必须从 msdb 数据库运行。

权限

可以授予 EXECUTE 此过程的权限,但在 SQL Server 升级期间可能会重写这些权限。

其他用户必须被授予数据库中以下SQL Server 代理固定数据库角色msdb之一:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

有关这些角色的权限的详细信息,请参阅 SQL Server 代理固定数据库角色

示例

以下示例报告有关操作员 François Ajenstat 的信息。

USE msdb;
GO

EXEC dbo.sp_help_operator
    @operator_name = N'François Ajenstat';
GO