sp_add_operator (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

アラートとジョブで使用するオペレーター (通知受信者) を作成します。

Transact-SQL 構文表記規則

構文

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

[ @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。 次の表に、各曜日の値を示します。

[ @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

関連するコンテンツ

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