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

    name に関連付けられた object_types だけを表示します。

    ALL

    name に関連付けられていないものも含め、すべての object_types を表示します。

    TARGET

    name に関連付けられているかどうかに関係なく、指定された target_name と一致する object_types だけを表示します。

  • [ @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 は、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

オペレータへの通知にポケットベルを使用するかどうか。

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