• 项目

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