sp_help_notification （Transact-SQL）

適用於：SQL Server

報告指定操作員的警示清單，或指定警示的運算子清單。

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 的警示，其中列出負責提供之警示名稱*的操作員*。*

[ @name = ] 'name' 操作員名稱（如果 object_type 為 OPERATORS）或警示名稱（如果 object_type 為 ALERTS）。 name 是 sysname ，沒有預設值。

[ @enum_type = ] 'enum_type' 傳 回object_type 資訊。 在大部分情況下，enum_type 為 ACTUAL。 enum_type 為 char（10）， 沒有預設值，而且可以是下列其中一個值。

值	Description
實際	僅 列出與 名稱 相關聯的object_types 。
ALL	列出所有 object_types ，包括未與 名稱相關聯的object_types 。
TARGET	只 列出符合所提供 target_name的object_types ，不論與 名稱 的關聯為何。

[ @notification_method = ] notification_method 數值，決定要傳回的通知方法資料行。 notification_method為 Tinyint ，可以是下列其中一個值。

值	名稱
1	電子郵件：只 傳回use_email 欄。
2	呼叫器：只 傳回use_pager 資料行。
4	NetSend：只 傳回use_netsend資料行 。
7	All：會傳回所有資料行。

[ @target_name = ] 'target_name' 要搜尋的警示名稱（如果 object_type 為 ALERTS），或要搜尋的操作員名稱（如果 object_type 為 OPERATORS）。 只有當enum_type為 TARGET 時 ，才需要target_name 。 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	為此警示傳送的 淨傳送 通知數目。

如果 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 notification。 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)