sp_help_operator (Transact-SQL)

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

Transact-SQL 语法约定

语法

sp_help_operator
     { [ @operator_name = ] 'operator_name' 
     | [ @operator_id = ] operator_id }

参数

• [ @operator_name= ] 'operator_name'
  操作员的名称。operator_name 的数据类型为 sysname。如果未指定 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	该操作员所属的操作员分类的名称。

注释

必须从 msdb 数据库运行 sp_help_operator。

权限

默认情况下，只有 sysadmin 固定服务器角色的成员才可以执行此存储过程。其他用户必须被授予 msdb 数据库中下列 SQL Server 代理固定数据库角色的权限之一：

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

示例

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

USE msdb ;
GO

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

请参阅

参考

sp_add_operator (Transact-SQL)

sp_delete_operator (Transact-SQL)

sp_update_operator (Transact-SQL)

系统存储过程 (Transact-SQL)