sp_help_notification (Transact-SQL)

報告一份給定操作員的警示清單,或一份給定警示的操作員清單。

主題連結圖示Transact-SQL 語法慣例

語法

sp_help_notification
     [ @object_type = ] 'object_type' ,
     [ @name = ] 'name' ,
     [ @enum_type = ] 'enum_type' , 
     [ @notification_method = ] notification_method 
     [ , [ @target_name = ] 'target_name' ] 

引數

  • [@object_type =] 'object_type'
    要傳回的資訊類型。object_type 是 char(9),沒有預設值。object_type 可能是 ALERTS 或 OPERATORS。ALERTS 會列出指派給所提供之操作員名稱的警示*,OPERATORS 會列出負責所提供之警示名稱的操作員。*

  • [@name =] 'name'
    運算子名稱 (如果 object_type 是 OPERATORS) 或警示名稱 (如果 object_type 是 ALERTS)。name 是 sysname,沒有預設值。

  • [@enum_type =] 'enum_type'
    傳回的 object_type 資訊。在大部分情況下,enum_type 是 ACTUAL。enum_type 是 char(10),沒有預設值,它可以是下列值之一。

    描述

    ACTUAL

    只列出關聯於 object_types 的 name。

    ALL

    列出所有 object_types,未關聯於name 的項目也包括在內。

    TARGET

    只列出符合所提供之 object_types 的 target_name,無論是否關聯於name,都是如此。

  • [@notification_method =] notification_method
    用來決定將傳回的通知方法資料行之數值。notification_method 是 tinyint,它可以是下列值之一。

    描述

    1

    電子郵件:只傳回 use_email 資料行。

    2

    呼叫器:只傳回 use_pager 資料行。

    4

    NetSend:只傳回 use_netsend 資料行。

    7

    全部:傳回所有資料行。

  • [@target_name =] 'target_name'
    要搜尋的警示名稱 (如果 object_type 是 ALERTS) 或要搜尋的操作員名稱 (如果 object_type 是 OPERATORS)。只有在 target_name 是 TARGET 時,才需要 enum_type。target_name 是 sysname,預設值是 NULL。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

如果 object_type 是 ALERTS,結果集會列出給定操作員的所有警示。

資料行名稱

資料類型

描述

alert_id

int

警示識別碼。

alert_name

sysname

警示名稱。

use_email

int

利用電子郵件來通知操作員:

1 = 是

0 = 否

use_pager

int

利用呼叫器來通知操作員:

1 = 是

0 = 否

use_netsend

int

利用網路快顯視窗來通知操作員:

1 = 是

0 = 否

has_email

int

這個警示所傳送的電子郵件通知數目。

has_pager

int

這個警示所傳送的呼叫器通知數目。

has_netsend

int

這個警示所傳送的 net send 通知數目。

如果 object_typeOPERATORS,結果集會列出給定警示的所有操作員。

資料行名稱

資料類型

描述

operator_id

int

操作員識別碼。

operator_name

sysname

操作員名稱。

use_email

int

利用電子郵件來傳送操作員的通知:

1 = 是

0 = 否

use_pager

int

利用呼叫器來傳送操作員的通知:

1 = 是

0 = 否

use_netsend

int

這是用來通知操作員的網路快顯視窗:

1 = 是

0 = 否

has_email

int

操作員有電子郵件地址:

1 = 是

0 = 否

has_pager

int

操作員具有呼叫器號碼:

1 = 是

0 = 否

has_netsend

int

操作員已設定了 net send 通知。

1 = 是

0 = 否

備註

這個預存程序必須從 msdb 資料庫中執行。

權限

若要執行這個預存程序,使用者必須是系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

A. 列出特定操作員的警示

下列範例會傳回 François Ajenstat 操作員收到的任何一種通知所針對的所有警示。

USE msdb ;
GO

EXEC dbo.sp_help_notification 
    @object_type = N'ALERTS',
    @name = N'François Ajenstat',
    @enum_type = N'ACTUAL',
    @notification_method = 7 ;
GO

B. 列出特定警示的操作員

下列範例會傳回收到 Test Alert 警示的任何一種通知的所有操作員。

USE msdb ;
GO

EXEC sp_help_notification
    @object_type = N'OPERATORS',
    @name = N'Test Alert',
    @enum_type = N'ACTUAL',
    @notification_method = 7 ;
GO