sp_update_operator (Transact-SQL)

適用対象:SQL Server

アラートとジョブで使用するオペレーター (通知受信者) に関する情報を更新します。

Transact-SQL 構文表記規則

構文

sp_update_operator
    [ @name = ] N'name'
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @email_address = ] N'email_address' ]
    [ , [ @pager_address = ] N'pager_address' ]
    [ , [ @weekday_pager_start_time = ] weekday_pager_start_time ]
    [ , [ @weekday_pager_end_time = ] weekday_pager_end_time ]
    [ , [ @saturday_pager_start_time = ] saturday_pager_start_time ]
    [ , [ @saturday_pager_end_time = ] saturday_pager_end_time ]
    [ , [ @sunday_pager_start_time = ] sunday_pager_start_time ]
    [ , [ @sunday_pager_end_time = ] sunday_pager_end_time ]
    [ , [ @pager_days = ] pager_days ]
    [ , [ @netsend_address = ] N'netsend_address' ]
    [ , [ @category_name = ] N'category_name' ]
[ ; ]

引数

[ @name = ] N'name'

変更するオペレーターの名前を指定します。 @nameは sysname で、既定値はありません。

[ @new_name = ] N'new_name'

演算子の新しい名前。 この名前は一意である必要があります。 @new_nameは sysname で、既定値は NULL.

[ @enabled = ] が有効

オペレーターの現在の状態を示す数値 (1 現在有効な場合、 0 有効でない場合)。 @enabledは tinyint で、既定値は NULL. 有効になっていない場合、オペレーターはアラート通知を受け取りません。

[ @email_address = ] N'email_address'

オペレーターの電子メール アドレス。 @email_addressは nvarchar(100) で、既定値は NULL. この文字列はメール システムに直接渡されます。

[ @pager_address = ] N'pager_address'

演算子のポケットベル アドレス。 @pager_addressは nvarchar(100) で、既定値は NULL. この文字列はメール システムに直接渡されます。

[ @weekday_pager_start_time = ] weekday_pager_start_time

月曜日から金曜日まで、ポケットベル通知をこのオペレーターに送信できる時間を指定します。 @weekday_pager_start_timeは int で、既定値は NULL24 時間制で使用するためにフォームHHmmssに入力する必要があります。

[ @weekday_pager_end_time = ] weekday_pager_end_time

月曜日から金曜日まで、指定したオペレーターにポケットベル通知を送信できない時間を指定します。 @weekday_pager_end_timeは int で、既定値は NULL24 時間制で使用するためにフォームHHmmssに入力する必要があります。

[ @saturday_pager_start_time = ] saturday_pager_start_time

土曜日に指定したオペレーターにポケットベル通知を送信できる時間を指定します。 @saturday_pager_start_timeは int で、既定値は NULL24 時間制で使用するためにフォームHHmmssに入力する必要があります。

[ @saturday_pager_end_time = ] saturday_pager_end_time

土曜日に指定したオペレーターにポケットベル通知を送信できない時間を指定します。 @saturday_pager_end_timeは int で、既定値は NULL24 時間制で使用するためにフォームHHmmssに入力する必要があります。

[ @sunday_pager_start_time = ] sunday_pager_start_time

日曜日に指定したオペレーターにポケットベル通知を送信できる時間を指定します。 @sunday_pager_start_timeは int で、既定値は NULL24 時間制で使用するためにフォームHHmmssに入力する必要があります。

[ @sunday_pager_end_time = ] sunday_pager_end_time

日曜日に指定したオペレーターにポケットベル通知を送信できない時間を指定します。 @sunday_pager_end_timeは int で、既定値は NULL24 時間制で使用するためにフォームHHmmssに入力する必要があります。

[ @pager_days = ] pager_days

オペレーターがページを受信できる日数を指定します (指定した開始時刻/終了時刻に従います)。 @pager_daysは tinyint で、既定値は NULL、~ の値0127である必要があります。 @pager_daysは、必要な日数の個々の値を追加することによって計算されます。 たとえば、月曜日から金曜日までは 28 + 16 + 32464 + + = .

Value 説明
1 日曜日
2 月曜日
4 火曜日
8 水曜日
16 Thursday
32 金曜日
64 土曜日

[ @netsend_address = ] N'netsend_address'

ネットワーク メッセージの送信先となるオペレーターのネットワーク アドレス。 @netsend_addressは nvarchar(100) で、既定値は NULL.

[ @category_name = ] N'category_name'

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

リターン コードの値

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

解説

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

アクセス許可

このプロシージャの実行権限は、既定では sysadmin 固定サーバー ロールのメンバーに与えられています。

次の例では、オペレーターの状態を更新し、オペレーターをtrueページングできる曜日 (月曜日から金曜日の午前 8 時から午後 5 時まで) を設定@enabledします。

USE msdb;
GO

EXEC dbo.sp_update_operator
    @name = N'François Ajenstat',
    @enabled = 1,
    @email_address = N'françoisa',
    @pager_address = N'5551290AW@pager.Adventure-Works.com',
    @weekday_pager_start_time = 080000,
    @weekday_pager_end_time = 170000,
    @pager_days = 64;
GO