[アーティクル]
04/01/2012

sp_help_alert (Transact-SQL)

特定のサーバーに対して定義された警告に関する情報をレポートします。

構文

sp_help_alert [ [ @alert_name = ] 'alert_name' ] 
     [ , [ @order_by = ] 'order_by' ] 
     [ , [ @alert_id = ] alert_id ] 
     [ , [ @category_name = ] 'category' ] 
     [ , [ @legacy_format = ] legacy_format ]

引数

[ @alert_name =] 'alert_name'
警告名を指定します。alert_name のデータ型は nvarchar(128) です。alert_name を指定しない場合は、すべての警告に関する情報が返されます。
[ @order_by =] 'order_by'
結果を作成するときの並べ替え順を指定します。order_by のデータ型は sysname で、既定値は N 'name' です。
[ @alert_id =] alert_id
情報をレポートする警告の識別番号を指定します。alert_id のデータ型は int で、既定値は NULL です。
[ @category_name = ] 'category'
警告のカテゴリを指定します。category のデータ型は sysname で、既定値は NULL です。
[ @legacy_format=] legacy_format
レガシバージョンの結果セットを作成するかどうかを指定します。legacy_format のデータ型は bit で、既定値は 0 です。legacy_format が 1 の場合、sp_help_alert は、Microsoft SQL Server 2000 の sp_help_alert で返される結果セットを返します。

戻り値

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

結果セット

@legacy_format が 0 の場合、sp_help_alert では次の結果セットが作成されます。

列名	データ型	説明
id	int	システムによって割り当てられた一意な整数識別子。
name	sysname	警告名 (例: Demo: Full msdb log)。
event_source	nvarchar(100)	イベントのソース。Microsoft SQL Server Version 7.0 の場合は、常に MSSQLServer となります。
event_category_id	int	単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。
event_id	int	単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。
message_id	int	警告を定義するメッセージエラー番号。通常は sysmessages テーブルのエラー番号と同じです。重大度レベルを使用して警告を定義する場合、message_id は 0 または NULL になります。
severity	int	警告を定義する重大度レベル (9 ～ 25、110、120、130、または 140)。
enabled	tinyint	警告が現在有効 (1) か無効 (0) かを示すステータス。有効でない警告は送信されません。
delay_between_responses	int	警告に対する 1 つの応答から次の応答までの待ち時間 (秒単位)。
last_occurrence_date	int	警告が最後に発生した日付。
last_occurrence_time	int	警告が最後に発生した時刻。
last_response_date	int	SQLServerAgent サービスが最後に警告に応答した日付。
last_response_time	int	SQLServerAgent サービスが最後に警告に応答した時刻。
notification_message	nvarchar(512)	電子メールやポケットベルによる通知の一部としてオペレータに送信する追加メッセージ (省略可)。
include_event_description	tinyint	Microsoft Windows アプリケーションログからの SQL Server エラーの説明を通知メッセージに含めるかどうか。
database_name	sysname	警告対象のエラーが発生したと考えられるデータベース。データベース名が NULL の場合は、エラーの発生場所に関係なく警告が発生します。
event_description_keyword	nvarchar(100)	Windows アプリケーションログ内の SQL Server エラーの説明。これには、提供されたものと同様の文字シーケンスが含まれている必要があります。
occurrence_count	int	警告の発生回数。
count_reset_date	int	occurrence_count を最後にリセットした日付。
count_reset_time	int	occurrence_count を最後にリセットした時刻。
job_id	uniqueidentifier	警告に応答して実行されるジョブの識別番号。
job_name	sysname	警告に応答して実行されるジョブの名前。
has_notification	int	1 人以上のオペレータに対して警告が通知される場合は、0 以外の値になります。値は次のとおりです。複数の場合は OR で表されます。 1 = 電子メール通知 2 = ポケットベル通知 4 = net send 通知
flags	int	単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。
performance_condition	nvarchar(512)	type が 2 の場合はパフォーマンス条件の定義、それ以外の場合は NULL。
category_name	sysname	単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。 SQL Server 7.0 の場合は常に '[Uncategorized]' となります。
wmi_namespace	sysname	type が 3 の場合、WMI イベントの名前空間。
wmi_query	nvarchar(512)	type が 3 の場合、WMI イベントのクエリ。
type	int	イベントの種類。 1 = SQL Server イベント警告 2 = SQL Server パフォーマンス警告 3 = WMI イベント警告

@legacy_format が 1 の場合、sp_help_alert では次の結果セットが作成されます。

列名	データ型	説明
id	int	システムによって割り当てられた一意な整数識別子。
name	sysname	警告名 (例: Demo: Full msdb log)。
event_source	nvarchar(100)	イベントのソース。SQL Server Version 7.0 の場合は、常に MSSQLServer となります。
event_category_id	int	単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。
event_id	int	単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。
message_id	int	警告を定義するメッセージエラー番号。通常は sysmessages テーブルのエラー番号と同じです。重大度レベルを使用して警告を定義する場合、message_id は 0 または NULL になります。
severity	int	警告を定義する重大度レベル (9 ～ 25、110、120、130、または 140)。
enabled	tinyint	警告が現在有効 (1) か無効 (0) かを示すステータス。有効でない警告は送信されません。
delay_between_responses	int	警告に対する 1 つの応答から次の応答までの待ち時間 (秒単位)。
last_occurrence_date	int	警告が最後に発生した日付。
last_occurrence_time	int	警告が最後に発生した時刻。
last_response_date	int	SQLServerAgent サービスが最後に警告に応答した日付。
last_response_time	int	SQLServerAgent サービスが最後に警告に応答した時刻。
notification_message	nvarchar(512)	電子メールやポケットベルによる通知の一部としてオペレータに送信する追加メッセージ (省略可)。
include_event_description	tinyint	Windows アプリケーションログからの SQL Server エラーの説明を通知メッセージに含めるかどうか。
database_name	sysname	警告対象のエラーが発生したと考えられるデータベース。データベース名が NULL の場合は、エラー発生の場所に関係なく警告が発生します。
event_description_keyword	nvarchar(100)	Windows アプリケーションログ内の SQL Server エラーの説明。これには、提供されたものと同様の文字シーケンスが含まれている必要があります。
occurrence_count	int	警告の発生回数。
count_reset_date	int	occurrence_count を最後にリセットした日付。
count_reset_time	int	occurrence_count を最後にリセットした時刻。
job_id	uniqueidentifier	ジョブ識別番号。
job_name	sysname	警告に応答して実行されるオンデマンドジョブ。
has_notification	int	1 人以上のオペレータに対して警告が通知される場合は、0 以外の値になります。値は次のとおりです。複数の場合は OR で表されます。 1 = 電子メール通知 2 = ポケットベル通知 4 = net send 通知
flags	int	単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。.
performance_condition	nvarchar(512)	type が 2 の場合、パフォーマンス条件の定義。type が 3 の場合、WMI イベントのクエリ。それ以外の場合は NULL。
category_name	sysname	単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。 SQL Server 7.0 の場合は常に '[Uncategorized]' となります。
type	int	警告の種類。 1 = SQL Server イベント警告 2 = SQL Server パフォーマンス警告 3 = WMI イベント警告

説明

sp_help_alert は msdb データベースから実行する必要があります。

権限

既定では、このストアドプロシージャを実行できるのは、sysadmin 固定サーバーロールのメンバです。それ以外のユーザーには、msdb データベースの SQLAgentOperatorRole 固定サーバーロールを与える必要があります。

SQLAgentOperatorRole の詳細については、「SQL Server エージェントの固定データベースロール」を参照してください。

例

次の例では、Demo: Sev. 25 Errors 警告に関する情報をレポートします。

USE msdb ;
GO

EXEC sp_help_alert @alert_name = 'Demo: Sev. 25 Errors'
GO

次の方法で共有

sp_help_alert (Transact-SQL)

構文

引数

戻り値

結果セット

説明

権限

例

関連項目

参照

その他のリソース