sp_help_notification (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_type 是 OPERATORS,結果集會列出給定警示的所有操作員。
資料行名稱 | 資料類型 | 描述 |
---|---|---|
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
請參閱
參考
sp_add_notification (Transact-SQL)
sp_delete_notification (Transact-SQL)
sp_update_notification (Transact-SQL)
系統預存程序 (Transact-SQL)