sp_update_operator (Transact-SQL)

適用対象: SQL サーバー

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

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 = ] 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 (既定値は NULL) であり、24 時間制で使用するには、 HHmmss 形式で入力する必要があります。

[ @weekday_pager_end_time = ] weekday_pager_end_time

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

[ @saturday_pager_start_time = ] saturday_pager_start_time

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

[ @saturday_pager_end_time = ] saturday_pager_end_time

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

[ @sunday_pager_start_time = ] sunday_pager_start_time

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

[ @sunday_pager_end_time = ] sunday_pager_end_time

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

[ @pager_days = ] pager_days

オペレーターがページを受信できる日数を指定します (指定した開始時刻/終了時刻に従います)。 @pager_days は tinyint で、既定値は NULL で、 0 から 127までの値である必要があります。 @pager_days は、必要な日数の個々の値を追加することによって計算されます。 たとえば、月曜日から金曜日まで 2 + 4 + 8 + 16 + 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 固定サーバー ロールのメンバーに与えられています。

例

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

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

関連するコンテンツ

• sp_add_operator (Transact-SQL)
• sp_delete_operator (Transact-SQL)
• sp_help_operator (Transact-SQL)
• システム ストアド プロシージャ (Transact-SQL)