sp_add_operator (Transact-SQL)
警告とジョブで使用するオペレーター (通知受信者) を作成します。
.gif "トピック リンク アイコン")
構文
sp_add_operator [ @name = ] 'name'
[ , [ @enabled = ] enabled ]
[ , [ @email_address = ] 'email_address' ]
[ , [ @pager_address = ] '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 = ] 'netsend_address' ]
[ , [ @category_name = ] 'category' ]
引数
[ @name= ] 'name'
オペレーター (通知受信者) の名前を指定します。 この名前は一意であることが必要で、パーセント (%) 文字は使用できません。 name のデータ型は sysname で、既定値はありません。[ @enabled= ] enabled
オペレーターの現在の状態を示します。 enabled のデータ型は tinyint で、既定値は 1 (有効) です。 0 を指定した場合、オペレーターは無効になり、通知を受信しません。[ @email_address= ] 'email_address'
オペレーターの電子メール アドレスを指定します。 この文字列はメール システムに直接渡されます。 email_address のデータ型は nvarchar(100) で、既定値は NULL です。実際の電子メール アドレスか、email_address の別名を指定できます。 次に例を示します。
'jdoe' または 'jdoe@xyz.com'
.gif "注意")
注データベース メールには電子メール アドレスを使用する必要があります。
[ @pager_address= ] 'pager_address'
オペレーターのポケットベルのアドレスを指定します。 この文字列はメール システムに直接渡されます。 pager_address のデータ型は narchar(100) で、既定値は NULL です。[ @weekday_pager_start_time= ] weekday_pager_start_time
月曜日から金曜日までの平日に、SQL Server エージェントが、指定されたオペレーターにポケットベルの通知を送信するときの開始時刻を指定します。 weekday_pager_start_time* *のデータ型は int で、既定値は 9:00 AM を 24 時間形式で表した 090000 です。 また、HHMMSS 形式で入力する必要があります。[ @weekday_pager_end_time= ] weekday_pager_end_time
月曜日から金曜日までの平日に、SQLServerAgent サービスが、指定されたオペレーターにポケットベルの通知を送信するときの終了時刻を指定します。 weekday_pager_end_timeのデータ型は int で、既定値は 6:00 PM を 24 時間制で表した 180000 です。 また、HHMMSS 形式で入力する必要があります。[ @saturday_pager_start_time =] saturday_pager_start_time
土曜日に、SQLServerAgent サービスが、指定されたオペレーターにポケットベルの通知を送信するときの開始時刻を指定します。 saturday_pager_start_time のデータ型は int で、既定値は 9:00 AM を 24 時間制で表した 090000 です。 また、HHMMSS 形式で入力する必要があります。[ @saturday_pager_end_time= ] saturday_pager_end_time
土曜日に、SQLServerAgent サービスが、指定されたオペレーターにポケットベルの通知を送信するときの終了時刻を指定します。 saturday_pager_end_timeのデータ型は int で、既定値は 6:00 PM を 24 時間制で表した 180000 です。 また、HHMMSS 形式で入力する必要があります。[ @sunday_pager_start_time= ] sunday_pager_start_time
日曜日に、SQLServerAgent サービスが、指定されたオペレーターにポケットベルの通知を送信するときの開始時刻を指定します。 sunday_pager_start_time* *のデータ型は int で、既定値は 9:00 AM を 24 時間形式で表した 090000 です。 また、HHMMSS 形式で入力する必要があります。[ @sunday_pager_end_time =] sunday_pager_end_time
日曜日に、SQLServerAgent サービスが、指定されたオペレーターにポケットベルの通知を送信するときの終了時刻を指定します。 sunday_pager_end_timeのデータ型は int で、既定値は 6:00 PM を 24 時間制で表した 180000 です。 また、HHMMSS 形式で入力する必要があります。[ @pager_days= ] pager_days
指定された開始時刻から終了時刻までの間に、オペレーターがポケットベルの通知を受信できる曜日を表す数値を指定します。 pager_daysのデータ型は tinyint で、既定値は、オペレーターがポケットベルの通知を受信できないことを示す 0 です。 有効な値は 0 から 127 です。 pager_daysは、必要となる曜日に対応する個々の値を加算することによって計算されます。 たとえば、月曜日から金曜日までは 2+4+8+16+32 = 62 となります。 次の表は、各曜日に対する値の一覧です。値
説明
1
日曜日
2
月曜日
4
火曜日
8
水曜日
16
木曜日
32
金曜日
64
土曜日
[ @netsend_address= ] 'netsend_address'
ネットワーク メッセージの送信先オペレーターのネットワーク アドレスを指定します。 netsend_addressのデータ型は nvarchar(100) で、既定値は NULL です。[ @category_name= ] 'category'
オペレーターのカテゴリの名前を指定します。 category のデータ型は sysname で、既定値は NULL です。
リターン コードの値
0 (成功) または 1 (失敗)
結果セット
なし
説明
sp_add_operator は、msdb データベースから実行する必要があります。
ポケットベルによる通知は電子メール システムによりサポートされます。ポケットベルによる通知を使用するには、電子メールからポケットベルへの通知機能を持つ電子メール システムを使用する必要があります。
SQL Server Management Studio は、ジョブを簡単に管理できるグラフィカルなツールです。ジョブのインフラストラクチャを作成し、管理するには、このツールを使用することをお勧めします。
権限
sp_add_operator を実行できるのは、sysadmin 固定サーバー ロールのメンバーだけです。
使用例
次の例では、danwi に対してオペレーター情報を設定します。 オペレーターは有効になっています。 SQL Server エージェントは、月曜日から金曜日の午前 8 時から午後 5 時まで、 ポケットベルによる通知を送信します。
USE msdb ;
GO
EXEC dbo.sp_add_operator
@name = N'Dan Wilson',
@enabled = 1,
@email_address = N'danwi',
@pager_address = N'5551290AW@pager.Adventure-Works.com',
@weekday_pager_start_time = 080000,
@weekday_pager_end_time = 170000,
@pager_days = 62 ;
GO
関連項目
参照
sp_delete_operator (Transact-SQL)
sp_help_operator (Transact-SQL)