sp_add_operator (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance
アラートとジョブで使用するオペレーター (通知受信者) を作成します。
構文
sp_add_operator
[ @name = ] '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 = ] 'category' ]
[ ; ]
引数
[ @name = ] 'name'
オペレーター (通知受信者) の名前。 この名前は一意である必要があり、パーセント (%) 文字を含めることはできません。 @name は sysname で、既定値はありません。
[ @enabled = ] enabled
演算子の現在の状態を示します。 @enabled は tinyint で、既定値は 1 (有効) です。 0場合、オペレーターは有効ではなく、通知を受け取りません。
[ @email_address = ] N'email_address'
オペレーターの電子メール アドレス。 この文字列はメール システムに直接渡されます。 @email_address は nvarchar(100)で、既定値は NULL です。
物理電子メール アドレスまたは @email_addressのエイリアスを指定できます。 次に例を示します。
fatmir.bregu または fatmir.bregu@contoso.com
Note
データベース メールには電子メール アドレスを使用する必要があります。
[ @pager_address = ] N'pager_address'
演算子のポケットベル アドレス。 この文字列はメール システムに直接渡されます。 @pager_address は nvarchar(100) で、既定値は NULL です。
[ @weekday_pager_start_time = ] weekday_pager_start_time
SQL Server エージェントが、月曜日から金曜日までの平日に指定したオペレーターにポケットベル通知を送信する時間。 @weekday_pager_start_time は int で、既定値は 090000 で、24 時間制の午前 9 時を示し、フォーム HHmmssを使用して入力する必要があります。
[ @weekday_pager_end_time = ] weekday_pager_end_time
SQL Server エージェントサービスが、月曜日から金曜日までの平日に指定されたオペレーターにポケットベル通知を送信しなくなった時間。 weekday_pager_end_time は int で、既定値は 180000 で、24 時間の午後 6 時を示し、フォーム HHmmssを使用して入力する必要があります。
[ @saturday_pager_start_time = ] saturday_pager_start_time
SQL Server エージェント サービスが土曜日に指定したオペレーターにポケットベル通知を送信する時間。 saturday_pager_start_time は int で、既定値は 090000 で、24 時間制で午前 9 時を示し、フォーム HHmmssを使用して入力する必要があります。
[ @saturday_pager_end_time = ] saturday_pager_end_time
SQL Server エージェントサービスが土曜日に指定したオペレーターにポケットベル通知を送信しなくなった時間。 @saturday_pager_end_time は int で、既定値は 180000 で、24 時間制の午後 6 時を示し、フォーム HHmmssを使用して入力する必要があります。
[ @sunday_pager_start_time = ] sunday_pager_start_time
SQL Server エージェント サービスが日曜日に指定したオペレーターにポケットベル通知を送信する時間。 @sunday_pager_start_time は int で、既定値は 090000 で、24 時間制の午前 9 時を示し、フォーム HHmmssを使用して入力する必要があります。
[ @sunday_pager_end_time = ] sunday_pager_end_time
SQL Server エージェント サービスが日曜日に指定したオペレーターにポケットベル通知を送信しなくなった時間。 @sunday_pager_end_time は int で、既定値は 180000 で、24 時間の午後 6 時を示し、フォーム HHmmssを使用して入力する必要があります。
[ @pager_days = ] pager_days
ページに対してオペレーターが使用できる日数を示す数値 (指定した開始時刻/終了時刻に従います)。 @pager_days は tinyint で、既定の 0 は、オペレーターがページを受信できない状態であることを示します。 有効な値は、 0 から 127までです。 @pager_days は、必要な日数の個々の値を追加することによって計算されます。 たとえば、月曜日から金曜日は 2 + 4 + 8 + 16 + 32 = 62。 次の表に、各曜日の値を示します。
| Value | 説明 |
|---|---|
1 |
日曜日 |
2 |
月曜日 |
4 |
火曜日 |
8 |
水曜日 |
16 |
Thursday |
32 |
金曜日 |
64 |
土曜日 |
[ @netsend_address = ] N'netsend_address'
ネットワーク メッセージの送信先となるオペレーターのネットワーク アドレス。 @netsend_address は nvarchar(100) で、既定値は NULL です。
[ @category_name = ] 'category'
オペレーターのカテゴリの名前を指定します。 @category_name は sysname で、既定値は NULL です。
リターン コードの値
0 (成功) または 1 (失敗)。
結果セット
ありません。
解説
sp_add_operator は、 msdb データベースから実行する必要があります。
ページングを使用する場合は、電子メール システムに電子メールからポケットベルへの機能が必要です。
SQL Server Management Studio は、簡単かつ直観的な方法でジョブを管理するためのツールで、ジョブ体系の作成および管理に最適です。
アクセス許可
このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTEアクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。
例
次の例では、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