適用対象:
SQL ServerAzure SQL Managed Instance
アラートとジョブで使用するオペレーター (通知受信者) を作成します。
構文
dbo.sp_add_operator
[ @name = ] N'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 = ] 名前
オペレーター (通知受信者) の名前。 この名前は一意である必要があり、パーセント (%) 文字を含めることはできません。
@name は sysname で、既定値はありません。
[ @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 Agentサービスが月曜から金曜まで、オペレーターにページャー通知を送らなくなる終了時間。
@weekday_pager_end_time は intで、デフォルトは 180000で、24時間制で午後6時を示し、フォーム HHmmssで入力する必要があります。
[ @saturday_pager_start_time = ] saturday_pager_start_time
SQL Server Agentサービスがオペレーターにページャー通知を送る土曜日の開始時間。
@saturday_pager_start_time は intで、デフォルトは 090000で、24時間制の午前9時を示し、フォーム HHmmssで入力する必要があります。
[ @saturday_pager_end_time = ] saturday_pager_end_time
SQL Server Agentサービスがオペレーターにページャー通知を送らなくなる土曜日の終了時間。
@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 Agentサービスがオペレーターにページャー通知を送らなくなる時間帯です。
@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。
次の表に、各曜日の値を示します。
| 値 | 説明 |
|---|---|
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 です。
この値が NULLの場合、演算子はデフォルトのカテゴリ [Uncategorized]を加えます。 既存のカテゴリからも、msdbデータベースのsyscategoriesテーブルから選択できます:
SELECT name
FROM msdb.dbo.syscategories;
リターン コードの値
0 (成功) または 1 (失敗)。
結果セット
ありません。
解説
sp_add_operator は、 msdb データベースから実行する必要があります。
ページングを使用する場合は、電子メール システムに電子メールからポケットベルへの機能が必要です。
SQL Server Management Studio は、簡単かつ直観的な方法でジョブを管理するためのツールで、ジョブ体系の作成および管理に最適です。
アクセス許可
この手順では EXECUTE アクセス許可を付与できますが、これらのアクセス許可は SQL Server のアップグレード中にオーバーライドされる可能性があります。
例
次の例では、danwi に対してオペレーター情報を設定します。 オペレーターは有効になっています。 SQL Server エージェントは、月曜日から金曜日の午前 8 時から午後 5 時まで、ポケットベルによって通知を送信します。
USE msdb;
GO
EXECUTE 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