sp_add_operator (Transact-SQL)sp_add_operator (Transact-SQL)

適用対象: yesSQL Server yesAzure SQL Database (Managed Instance のみ) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

警告およびジョブで使用するオペレーター (通知受信者) を作成します。Creates an operator (notification recipient) for use with alerts and jobs.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

  
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' ]   

引数Arguments

オペレーター (通知受信者) の名前 [ @name = ] 'name' ます。[ @name = ] 'name' The name of an operator (notification recipient). この名前は一意である必要があり、パーセント ( % ) 文字を含めることはできません。This name must be unique and cannot contain the percent (%) character. 名前sysname,、既定値はありません。name is sysname, with no default.

[ @enabled = ] enabled 演算子の現在の状態を示します。[ @enabled = ] enabled Indicates the current status of the operator. 有効になっているはtinyint,、既定値は1 (有効) です。enabled is tinyint, with a default of 1 (enabled). 0の場合、オペレーターは無効になり、通知を受信しません。If 0, the operator is not enabled and does not receive notifications.

オペレーターの電子メールアドレスを [ @email_address = ] 'email_address' します。[ @email_address = ] 'email_address' The e-mail address of the operator. この文字列はメール システムに直接渡されます。This string is passed directly to the e-mail system. email_addressnvarchar (100) ,、既定値は NULL です。email_address is nvarchar(100), with a default of NULL.

Email_addressには、物理電子メールアドレスまたはエイリアスを指定できます。You can specify either a physical e-mail address or an alias for email_address. 例 :For example:

'jdoe' または 'jdoe@xyz.com''jdoe' or 'jdoe@xyz.com'

注意

データベース メールには電子メール アドレスを使用する必要があります。You must use the e-mail address for Database Mail.

オペレーターのポケットベルアドレスを [ @pager_address = ] 'pager_address' します。[ @pager_address = ] 'pager_address' The pager address of the operator. この文字列はメール システムに直接渡されます。This string is passed directly to the e-mail system. pager_addressnvarchar (100) ,、既定値は NULL です。pager_address is nvarchar(100), with a default of NULL.

SQL ServerSQL Server エージェントが平日の月曜日から金曜日までの、指定されたオペレーターにポケットベルによる通知を送信するまでの時間を [ @weekday_pager_start_time = ] weekday_pager_start_time します。[ @weekday_pager_start_time = ] weekday_pager_start_time The time after which SQL ServerSQL Server Agent sends pager notification to the specified operator on the weekdays, from Monday through Friday. weekday_pager_start_timeint,、既定値は090000,、9:00 A.M. を示すweekday_pager_start_timeis int, with a default of 090000, which indicates 9:00 A.M. を 24 時間形式で表したものです。HHMMSS 形式で入力する必要があります。on a 24-hour clock, and must be entered using the form HHMMSS.

月曜日から金曜日までの平日に、 SQLServerAgentサービスが、指定されたオペレーターにポケットベルによる通知を送信しなくなる時刻を [ @weekday_pager_end_time = ] weekday_pager_end_time します。[ @weekday_pager_end_time = ] weekday_pager_end_time The time after which SQLServerAgent service no longer sends pager notification to the specified operator on the weekdays, from Monday through Friday. weekday_pager_end_timeint,、既定値は 18万,、6:00 pm を示すweekday_pager_end_timeis int, with a default of 180000, which indicates 6:00 P.M. を 24 時間形式で表したものです。HHMMSS 形式で入力する必要があります。on a 24-hour clock, and must be entered using the form HHMMSS.

土曜日に、 SQLServerAgentサービスが、指定されたオペレーターにポケットベルによる通知を送信するまでの時間を [ @saturday_pager_start_time = ] saturday_pager_start_time します。[ @saturday_pager_start_time = ] saturday_pager_start_time The time after which SQLServerAgent service sends pager notification to the specified operator on Saturdays. saturday_pager_start_timeint,、既定値は 090000,、9:00 A.M. を示すsaturday_pager_start_time is int, with a default of 090000, which indicates 9:00 A.M. を 24 時間形式で表したものです。HHMMSS 形式で入力する必要があります。on a 24-hour clock, and must be entered using the form HHMMSS.

土曜日に、 SQLServerAgentサービスが、指定されたオペレーターにポケットベルによる通知を送信しなくなる時刻を [ @saturday_pager_end_time = ] saturday_pager_end_time します。[ @saturday_pager_end_time = ] saturday_pager_end_time The time after which SQLServerAgent service no longer sends pager notification to the specified operator on Saturdays. saturday_pager_end_timeint,、既定値は18万,、6:00 pm を示すsaturday_pager_end_timeis int, with a default of 180000, which indicates 6:00 P.M. を 24 時間形式で表したものです。HHMMSS 形式で入力する必要があります。on a 24-hour clock, and must be entered using the form HHMMSS.

毎週日曜日に、 SQLServerAgentサービスが、指定されたオペレーターにポケットベルによる通知を送信するまでの時間を [ @sunday_pager_start_time = ] sunday_pager_start_time します。[ @sunday_pager_start_time = ] sunday_pager_start_time The time after which SQLServerAgent service sends pager notification to the specified operator on Sundays. sunday_pager_start_timeint,、既定値は090000,、9:00 A.M. を示すsunday_pager_start_timeis int, with a default of 090000, which indicates 9:00 A.M. を 24 時間形式で表したものです。HHMMSS 形式で入力する必要があります。on a 24-hour clock, and must be entered using the form HHMMSS.

毎週日曜日に、 SQLServerAgentサービスが、指定されたオペレーターにポケットベルによる通知を送信しなくなる時刻を [ @sunday_pager_end_time = ] sunday_pager_end_time します。[ @sunday_pager_end_time = ] sunday_pager_end_time The time after which SQLServerAgent service no longer sends pager notification to the specified operator on Sundays. sunday_pager_end_timeint,、既定値は18万,、6:00 pm を示すsunday_pager_end_timeis int, with a default of 180000, which indicates 6:00 P.M. を 24 時間形式で表したものです。HHMMSS 形式で入力する必要があります。on a 24-hour clock, and must be entered using the form HHMMSS.

[ @pager_days = ] pager_days は、指定された開始/終了時刻に従って、ページでオペレーターが使用できる日数を示す数値です。[ @pager_days = ] pager_days Is a number that indicates the days that the operator is available for pages (subject to the specified start/end times). pager_daystinyint,、既定値は0の場合、操作がページを受信できないことを示します。pager_daysis tinyint, with a default of 0 indicating the operator is never available to receive a page. 有効な値は0 ~ 127です。Valid values are from 0 through 127. pager_daysは、必要な日数の個々の値を加算することによって計算されます。pager_daysis calculated by adding the individual values for the required days. たとえば、月曜日から金曜日までは2+4+8+16+32 = 62になります。For example, from Monday through Friday is 2+4+8+16+32 = 62. 次の表は、各曜日の値を示しています。The following table lists the value for each day of the week.

ReplTest1Value [説明]Description
11 日曜日Sunday
22 月曜日Monday
44 火曜日Tuesday
88 水曜日Wednesday
1616 木曜日Thursday
3232 金曜日Friday
6464 土曜日Saturday

ネットワークメッセージを送信するオペレーターのネットワークアドレスを [ @netsend_address = ] 'netsend_address' します。[ @netsend_address = ] 'netsend_address' The network address of the operator to whom the network message is sent. netsend_addressnvarchar (100) ,、既定値は NULL です。netsend_addressis nvarchar(100), with a default of NULL.

このオペレーターのカテゴリの名前 [ @category_name = ] 'category' ます。[ @category_name = ] 'category' The name of the category for this operator. categorysysname,、既定値は NULL です。category is sysname, with a default of NULL.

リターン コードの値Return Code Values

0 (成功) または1 (失敗)0 (success) or 1 (failure)

結果セットResult Sets

[InclusionThresholdSetting]None

RemarksRemarks

sp_add_operatorは、 msdbデータベースから実行する必要があります。sp_add_operator must be run from the msdb database.

ページングは電子メールシステムでサポートされています。ページングを使用する場合は、電子メールとポケットベルの機能が必要です。Paging is supported by the e-mail system, which must have an e-mail-to-pager capability if you want to use paging.

SQL Server Management StudioSQL Server Management Studio は、ジョブを簡単に管理できるグラフィカルなツールです。ジョブのインフラストラクチャを作成し、管理するには、このツールを使用することをお勧めします。provides an easy, graphical way to manage jobs, and is the recommended way to create and manage the job infrastructure.

アクセス許可Permissions

Sp_add_operatorを実行できるのは、 sysadmin固定サーバーロールのメンバーだけです。Only members of the sysadmin fixed server role can execute sp_add_operator.

使用例Examples

次の例では、danwi に対してオペレーター情報を設定します。The following example sets up the operator information for danwi. オペレーターは有効になっています。The operator is enabled. SQL ServerSQL Server エージェントは、月曜日から金曜日の午前 8 時から午後 5 時まで、Agent sends notifications by pager from Monday through Friday from 8 A.M. ポケットベルによる通知を送信します。to 5 P.M.

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  

参照See Also

transact-sql ( の) sp_delete_operatorsp_delete_operator (Transact-SQL)
transact-sql ( の) sp_help_operatorsp_help_operator (Transact-SQL)
transact-sql ( の) sp_update_operatorsp_update_operator (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)System Stored Procedures (Transact-SQL)