sp_add_operator (Transact-SQL)
警告とジョブで使用するオペレータ (通知受信者) を作成します。
構文
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'
- [ @pager_address= ] 'pager_address'
オペレータのポケットベルのアドレスを指定します。この文字列はメール システムに直接渡されます。pager_address のデータ型は narchar(100) で、既定値は NULL です。
- [ @weekday_pager_start_time= ] weekday_pager_start_time
月曜日から金曜日までの平日に、Microsoft 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 です。
結果セット
なし
解説
sp_add_operator は、msdb データベースから実行する必要があります。
ポケットベルによる通知は電子メール システムによりサポートされます。ポケットベルによる通知を使用するには、電子メールからポケットベルへの通知機能を持つ電子メール システムを使用する必要があります。
SQL Server Management Studio は、ジョブを簡単に管理できるグラフィカルなツールです。ジョブのインフラストラクチャを作成し、管理するには、SQL Server Management Studio を使用することをお勧めします。
権限
sp_add_operator を実行できるのは、sysadmin 固定サーバー ロールのメンバだけです。
戻り値
0 (成功) または 1 (失敗)
例
次の例では、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)
sp_update_operator (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)