sp_help_alert (Transact-SQL)
適用対象: 
SQL サーバー
特定のサーバーに対して定義された警告に関する情報をレポートします。
構文
sp_help_alert
[ [ @alert_name = ] N'alert_name' ]
[ , [ @order_by = ] N'order_by' ]
[ , [ @alert_id = ] alert_id ]
[ , [ @category_name = ] N'category_name' ]
[ , [ @legacy_format = ] legacy_format ]
[ ; ]
引数
[ @alert_name = ] N'alert_name'
警告名を指定します。 @alert_name は sysname で、既定値は NULL です。 @alert_nameが指定されていない場合は、すべてのアラートに関する情報が返されます。
[ @order_by = ] N'order_by'
結果を作成するときの並べ替え順を指定します。 @order_by は sysname で、既定値は @alert_name です。
[ @alert_id = ] alert_id
情報をレポートする警告の識別番号を指定します。 @alert_id は int で、既定値は NULL です。
[ @category_name = ] N'category_name'
警告のカテゴリを指定します。 @category_name は sysname で、既定値は NULL です。
[ @legacy_format = ] legacy_format
レガシ結果セットを生成するかどうかを指定します。 @legacy_format は bit で、既定値は 0 です。 @legacy_formatが1されると、sp_help_alertは SQL Server 2000 (8.x) のsp_help_alertによって返される結果セットを返します。
リターン コードの値
0 (成功) または 1 (失敗)。
結果セット
次の表は、SQL Server 2005 (9.x) 以降のバージョンの @legacy_format が 0されている場合の出力のみを示しています。
| 列名 | データ型 | 説明 |
|---|---|---|
id |
int | システムによって割り当てられた一意な整数識別子。 |
name |
sysname | アラート名 (たとえば、 Demo: Full msdb log)。 |
event_source |
nvarchar(100) | イベントのソース。 |
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 | アラートへの応答の間の待機時間 (秒単位)。 |
last_occurrence_date |
int | 警告が最後に発生した日付。 |
last_occurrence_time |
int | アラートが最後に発生した時刻。 |
last_response_date |
int | SQL Server エージェント サービスによってアラートが最後に応答された日付。 |
last_response_time |
int | SQL Server エージェント サービスによってアラートが最後に応答された時刻。 |
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 以外。 値は、次の 1 つ以上の値です (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 イベント アラート |
解説
sp_help_alert は、 msdb データベースから実行する必要があります。
アクセス許可
このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTEアクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。
他のユーザーには、msdb データベース内の次SQL Server エージェント固定データベース ロールのいずれかを付与する必要があります。
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。
例
次の例では、Demo: Sev. 25 Errors 警告に関する情報をレポートします。
USE msdb;
GO
EXEC sp_help_alert @alert_name = 'Demo: Sev. 25 Errors';
GO