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	這位操作員所屬的操作員類別目錄名稱。

備註

sp_help_operator 必須從 msdb 資料庫中執行。

權限

依預設，只有系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行這個預存程序。 其他使用者必須被授與 msdb 資料庫的下列其中一個 SQL Server Agent 固定資料庫角色。

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

如需有關這些角色權限的詳細資料，請參閱＜SQL Server Agent 固定資料庫角色＞。

範例

下列範例會報告 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)