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は nvarchar(128) です。 @alert_nameが指定されていない場合は、すべてのアラートに関する情報が返されます。

[ @order_by = ] N'order_by'

結果を作成するときの並べ替え順を指定します。 @order_byは sysname で、既定値は @alert_name です。

[ @alert_id = ] alert_id

情報をレポートする警告の識別番号を指定します。 @alert_idは int で、既定値は NULL.

[ @category_name = ] N'category'

警告のカテゴリを指定します。 @categoryは 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すると0、sp_help_alert次の結果セットが生成されます。

列名 データ型 説明
id int システムによって割り当てられた一意な整数識別子。
name sysname アラート名 (デモ: 完全 msdb ログなど)。
event_source nvarchar(100) イベントのソース。 これは常に Microsoft SQL Server バージョン 7.0 用ですMSSQLServer
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=has e-mail notification
2=has pager notification
4= 通知があります net send 。
flags int 単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。
performance_condition nvarchar(512) ある2場合、この列にはパフォーマンス条件の定義が表示されます。それ以外の場合type、列は NULL.
category_name sysname 単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。 SQL Server 7.0 では常に '[未分類]' になります。
wmi_namespace sysname ある場合 type 、この列には 3WMI イベントの名前空間が表示されます。
wmi_query nvarchar(512) ある場合 type 、この列には 3WMI イベントのクエリが表示されます。
type int イベントの種類:

1 = SQL Server イベント アラート
2 = SQL Server パフォーマンス アラート
3 = WMI イベント アラート

@legacy_formatすると1、sp_help_alert次の結果セットが生成されます。

列名 データ型 説明
id int システムによって割り当てられた一意な整数識別子。
name sysname アラート名 (デモ: 完全 msdb ログなど)。
event_source nvarchar(100) イベントのソース。 これは常に SQL Server バージョン 7.0 用ですMSSQLServer
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 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 ジョブ ID 番号。
job_name sysname アラートに応答して実行されるオンデマンド ジョブ。
has_notification int このアラートに対して 1 つ以上のオペレーターに通知される場合は 0 以外。 値は次のとおりです。複数の場合は OR で表されます。

1=has e-mail notification
2=has pager notification
4=has net send notification.
flags int 単に情報を示すためだけに特定されます。 サポートされていません。 今後の互換性は保証されません。.
performance_condition nvarchar(512) ある場合 type 、 2この列にはパフォーマンス条件の定義が表示されます。 ある場合 type 、この列には 3WMI イベントのクエリが表示されます。 それ以外の場合、列は NULL.
category_name sysname 単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。 常に SQL Server 7.0 用になります [Uncategorized] 。
type int アラートの種類:

1 = SQL Server イベント アラート
2 = SQL Server パフォーマンス アラート
3 = WMI イベント アラート

解説

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

アクセス許可

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

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

例

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

USE msdb;
GO

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

関連するコンテンツ