• 發行項

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