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

関連するコンテンツ