sp_help_alert (Transact-SQL)

適用対象: SQL サーバー

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

Transact-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

関連するコンテンツ

• sp_add_alert (Transact-SQL)
• sp_update_alert (Transact-SQL)
• システム ストアド プロシージャ (Transact-SQL)