sp_add_operator (Transact-SQL)

  • [アーティクル]

適用対象: SQL ServerAzure 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は 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 で、既定値は 09000024 時間制の午前 9 時を示し、フォームHHmmssを使用して入力する必要があります。

[ @weekday_pager_end_time = ] weekday_pager_end_time

SQL Server エージェントサービスが、月曜日から金曜日までの平日に指定されたオペレーターにポケットベル通知を送信しなくなった時間。 weekday_pager_end_timeは int で、既定値は 18000024 時間制の午後 6 時を示し、フォームHHmmssを使用して入力する必要があります。

[ @saturday_pager_start_time = ] saturday_pager_start_time

SQL Server エージェント サービスが土曜日に指定したオペレーターにポケットベル通知を送信する時間。 saturday_pager_start_timeは int で、既定値は 09000024 時間制の午前 9 時を示し、フォームHHmmssを使用して入力する必要があります。

[ @saturday_pager_end_time = ] saturday_pager_end_time

SQL Server エージェントサービスが土曜日に指定したオペレーターにポケットベル通知を送信しなくなった時間。 @saturday_pager_end_timeは int で、既定値は 18000024 時間制の午後 6 時を示し、フォームHHmmssを使用して入力する必要があります。

[ @sunday_pager_start_time = ] sunday_pager_start_time

SQL Server エージェント サービスが日曜日に指定したオペレーターにポケットベル通知を送信する時間。 @sunday_pager_start_timeは int で、既定値は 09000024 時間制の午前 9 時を示し、フォームHHmmssを使用して入力する必要があります。

[ @sunday_pager_end_time = ] sunday_pager_end_time

SQL Server エージェント サービスが日曜日に指定したオペレーターにポケットベル通知を送信しなくなった時間。 @sunday_pager_end_timeは int で、既定値は 18000024 時間制の午後 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

関連するコンテンツ