sp_help_alert (Transact-SQL)

適用対象:SQL Server

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

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はビットで、既定値は 0. @legacy_formatの場合は1、 sp_help_alert SQL Server 2000 (8.x) で返されるsp_help_alert結果セットを返します。

リターン コードの値

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

結果セット

次の表は、@legacy_formatが 0SQL Server 2005 (9.x) 以降のバージョンの場合の出力のみを示しています。

列名	データ型	説明
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	アラートを定義する重大度レベル (from 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 つ以上の値 (OR1 つにまとめられた値) です。 1 = 電子メール通知がある 2 = ポケットベル通知がある 4= net send notification を持っています。
flags	int	単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。
performance_condition	nvarchar(512)	ある2場合、この列にはパフォーマンス条件の定義が表示されます。それ以外の場合type、列は NULL.
category_name	sysname	単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。 常に SQL Server 7.0 用になります [Uncategorized] 。
wmi_namespace	sysname	ある場合 type 、この列には 3WMI イベントの名前空間が表示されます。
wmi_query	nvarchar(512)	ある場合 type 、この列には 3WMI イベントのクエリが表示されます。
type	int	イベントの種類: 1 = SQL Server イベント アラート 2 = SQL Server パフォーマンス アラート 3 = WMI イベント アラート

解説

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

アクセス許可

このストアド プロシージャは、db_owner ロールによって所有されています。 任意のユーザーにアクセス許可を付与 EXECUTE できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

他のユーザーには、データベース内の固定データベース ロールSQL Server エージェント次のいずれかを付与するmsdb必要があります。

• 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)