sp_help_notification (Transact-SQL)

[アーティクル]
05/23/2023

適用対象:SQL Server

特定のオペレーターのアラートの一覧、または特定のアラートのオペレーターの一覧を報告します。

構文

  
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は実際です。 enum_typeは char(10)で、既定値は指定せず、これらの値のいずれかを指定できます。

値	説明
ACTUAL	名前に関連付けられている object_types のみを一覧表示します。
ALL	名前に関連付けられていないものも含め、すべてのobject_types を一覧表示します。
TARGET	名前との関連付けに関係なく、指定されたtarget_nameに一致する object_typesのみを一覧表示します。

[ @notification_method = ] notification_method 返す通知メソッド列を決定する数値。 notification_method は tinyint で、次のいずれかの値を指定できます。

値	説明
1	電子メール: use_email 列のみを返します。
2	Pager: use_pager 列のみを返します。
4	NetSend: use_netsend 列のみを返します。
7	All: すべての列を返します。

[ @target_name = ] 'target_name' 検索するアラート名 ( object_type が ALERTS の場合) または検索するオペレーター名 ( object_type が OPERATORS の場合)。 target_name は、 enum_type が TARGET の場合にのみ必要です。 target_name は sysname で、既定値は NULL です。

リターンコードバルブ

0 (成功) または 1 (失敗)

結果セット

object_typeが ALERTS の場合、結果セットには、特定のオペレーターのすべてのアラートが一覧表示されます。

列名	データ型	説明
alert_id	int	アラート識別子番号。
alert_name	sysname	アラート名。
use_email	int	電子メールは、オペレーターに通知するために使用されます。 1 = はい 0 = いいえ
use_pager	int	Pager は、オペレーターに通知するために使用されます。 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	オペレーターはネット送信通知を構成しています。 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)