sp_update_alert (Transact-SQL)

適用対象:SQL Server

既存のアラートの設定を更新します。

Transact-SQL 構文表記規則

構文

sp_update_alert
    [ @name = ] N'name'
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @message_id = ] message_id ]
    [ , [ @severity = ] severity ]
    [ , [ @delay_between_responses = ] delay_between_responses ]
    [ , [ @notification_message = ] N'notification_message' ]
    [ , [ @include_event_description_in = ] include_event_description_in ]
    [ , [ @database_name = ] N'database_name' ]
    [ , [ @event_description_keyword = ] N'event_description_keyword' ]
    [ , [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @occurrence_count = ] occurrence_count ]
    [ , [ @count_reset_date = ] count_reset_date ]
    [ , [ @count_reset_time = ] count_reset_time ]
    [ , [ @last_occurrence_date = ] last_occurrence_date ]
    [ , [ @last_occurrence_time = ] last_occurrence_time ]
    [ , [ @last_response_date = ] last_response_date ]
    [ , [ @last_response_time = ] last_response_time ]
    [ , [ @raise_snmp_trap = ] raise_snmp_trap ]
    [ , [ @performance_condition = ] N'performance_condition' ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @wmi_namespace = ] N'wmi_namespace' ]
    [ , [ @wmi_query = ] N'wmi_query' ]
[ ; ]

引数

[ @name = ] N'name'

更新する警告の名前を指定します。 @nameは sysname で、既定値はありません。

[ @new_name = ] N'new_name'

アラートの新しい名前。 名前は一意である必要があります。 @new_nameは sysname で、既定値は NULL.

[ @enabled = ] が有効

アラートが有効 () か有効1でない0 () かを指定します。 @enabledは tinyint で、既定値は NULL. アラートを起動するには、有効にする必要があります。

[ @message_id = ] message_id

警告定義のための新しいメッセージまたはエラー番号を指定します。 通常、message_idは sysmessages テーブルのエラー番号に対応します。 @message_idは int で、既定値は NULL. メッセージ ID は、アラートの重大度レベルの設定が 0次の場合にのみ使用できます。

[ @severity = ] 重大度

アラート定義の新しい重大度レベル (from 1 through 25)。 指定された重大度の Windows アプリケーション ログに送信された SQL Server メッセージは、アラートをアクティブにします。 @severityは int で、既定値は NULL. 重大度レベルは、アラートのメッセージ ID 設定が 0.

[ @delay_between_responses = ] delay_between_responses

警告に対する 1 つの応答から次の応答までの、新しい待機時間を秒単位で指定します。 @delay_between_responsesは int で、既定値は NULL.

[ @notification_message = ] N'notification_message'

電子メール、ネット送信、またはポケットベル通知の一部としてオペレーターに送信される追加メッセージの変更されたテキスト。 @notification_messageは nvarchar(512) で、既定値は NULL.

[ @include_event_description_in = ] include_event_description_in

Windows アプリケーション ログからの SQL Server エラーの説明を通知メッセージに含めるかどうかを指定します。 @include_event_description_inは tinyint であり、これらの値の 1 つ以上を指定できます。

Value	説明
0	なし
1	メール
2	ポケットベル
4	net send
7	すべて

[ @database_name = ] N'database_name'

警告に関連するデータベースの名前を指定します。警告を発するには、このデータベースでエラーが発生する必要があります。 @database_nameは sysname で、既定値は NULL. 角かっこ ([]) で囲まれた名前は使用できません。

[ @event_description_keyword = ] N'event_description_キーワード (keyword)'

エラー メッセージ ログの SQL Server エラーの説明に含まれている必要がある一連の文字。 @event_description_キーワード (keyword)は nvarchar(100) で、既定値は NULL. このパラメーターは、オブジェクト名 (たとえば) をフィルター処理する場合に customer_table便利です。

Note

Transact-SQL LIKE 式のパターンマッチング文字は使用できません。

[ @job_id = ] 'job_id'

@job_idは uniqueidentifier で、既定値は NULL.

[ @job_name = ] N'job_name'

ジョブ ID 番号。 @job_nameは sysname で、既定値は NULL. job_idを指定する場合は、job_nameを省略する必要があります。

[ @occurrence_count = ] occurrence_count

警告が発生した回数をリセットします。 @occurrence_countは int で、既定値は NULL、に設定0することしかできません。

[ @count_reset_date = ] count_reset_date

発生回数が最後にリセットされた日付をリセットします。 @count_reset_dateは int で、既定値は NULL.

[ @count_reset_time = ] count_reset_time

発生回数が最後にリセットされた時刻をリセットします。 @count_reset_timeは int で、既定値は NULL.

[ @last_occurrence_date = ] last_occurrence_date

アラートが最後に発生した日付をリセットします。 @last_occurrence_dateは int で、既定値は NULL、に設定できます0。

[ @last_occurrence_time = ] last_occurrence_time

警告が最後に発生した時刻をリセットします。 @last_occurrence_timeは int で、既定値は NULL> に設定できます0。

[ @last_response_date = ] last_response_date

SQLServerAgent サービスが最後に警告に応答した日付をリセットします。 @last_response_dateは int で、既定値は NULL、に設定できます0。

[ @last_response_time = ] last_response_time

SQLServerAgent サービスが最後に警告に応答した時刻をリセットします。 @last_response_timeは int で、既定値は NULL、に設定できます0。

[ @raise_snmp_trap = ] raise_snmp_trap

単に情報を示すためだけに特定されます。 サポートされていません。 将来の互換性は保証されません。

[ @performance_condition = ] N'performance_condition'

形式 <itemcomparatorvalue>で表される値。 @performance_conditionは nvarchar(512)で、次の要素で構成されます。

Format 要素	説明
品目	パフォーマンス オブジェクト、パフォーマンス カウンター、またはカウンターの名前付きインスタンス。
コンパレータ	これらの演算子の 1 つ: >, , <=
Value	カウンターの数値

[ @category_name = ] N'category_name'

アラート カテゴリの名前。 @category_nameは sysname で、既定値は NULL.

[ @wmi_namespace = ] N'wmi_namespace'

イベントのクエリを実行する WMI 名前空間。 @wmi_namespaceは sysname で、既定値は NULL.

[ @wmi_query = ] N'wmi_query'

アラートの WMI イベントを指定するクエリ。 @wmi_queryは nvarchar(512) で、既定値は NULL.

リターン コードの値

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

解説

Windows アプリケーション ログに書き込まれた場合にのみ sysmessages 、アラートを発生させることができます。

sp_update_alert では、パラメーター値が指定されているアラート設定のみが変更されます。 パラメーターを省略すると、現在の設定は保持されます。

アクセス許可

このストアド プロシージャを実行するには、ユーザーが sysadmin 固定サーバー ロールのメンバーである必要があります。

例

次の例では、警告が有効になっている Test Alert の設定を 0 (無効) に変更します。

USE msdb;
GO

EXEC dbo.sp_update_alert
    @name = N'Test Alert',
    @enabled = 0;
GO

関連するコンテンツ

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