共用方式為


sp_add_operator (Transact-SQL)

適用於:SQL Server Azure SQL 受控執行個體

建立操作員 (通知收件者) 以搭配警示和作業使用。

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.bregufatmir.bregu@contoso.com

注意

您必須使用 Database Mail 的電子郵件位址。

[ @pager_address = ] N'pager_address'

運算子的呼叫器位址。 此字串會直接傳遞至電子郵件系統。 @pager_address為 nvarchar(100),預設值為 NULL

[ @weekday_pager_start_time = ] weekday_pager_start_time

從星期一到星期五,SQL Server Agent 在工作日傳送呼叫器通知給指定的操作員的時間。 @weekday_pager_start_time為 int,預設值090000為 ,表示 24 小時制的上午 9:00,且必須使用 表單HHmmss輸入 。

[ @weekday_pager_end_time = ] weekday_pager_end_time

從星期一到星期五,SQL Server Agent 服務在工作日不再傳送呼叫器通知給指定的操作員的時間。 weekday_pager_end_time為 int,預設值180000為 ,表示下午 24 小時制的下午 6:00,而且必須使用 表單HHmmss輸入 。

[ @saturday_pager_start_time = ] saturday_pager_start_time

SQL Server Agent 服務在星期六傳送呼叫器通知給指定操作員的時間。 saturday_pager_start_time為 int,預設值090000為 ,表示 24 小時制的上午 9:00,而且必須使用 表單HHmmss輸入 。

[ @saturday_pager_end_time = ] saturday_pager_end_time

SQL Server Agent 服務在週六不再傳送呼叫器通知給指定的操作員的時間。 @saturday_pager_end_time為 int,預設值180000為 ,表示下午 24 小時制的下午 6:00,且必須使用 表單HHmmss輸入 。

[ @sunday_pager_start_time = ] sunday_pager_start_time

SQL Server Agent 服務在星期日傳送呼叫器通知給指定操作員的時間。 @sunday_pager_start_time為 int,預設值090000為 ,表示 24 小時制的上午 9:00,且必須使用 表單HHmmss輸入 。

[ @sunday_pager_end_time = ] sunday_pager_end_time

SQL Server Agent 服務不再在星期日傳送呼叫器通知給指定的操作員的時間。 @sunday_pager_end_time為 int,預設值180000為 ,表示下午 6:00 在 24 小時制,且必須使用 表單HHmmss輸入 。

[ @pager_days = ] pager_days

數位,指出運算符可用於頁面的天數(受限於指定的開始/結束時間)。 @pager_days為 tinyint,預設值0表示運算符永遠無法接收頁面。 有效值是從 0127@pager_days是藉由新增所需天數的個別值來計算。 例如,從星期一到星期五是 2 + 4 + 8 + 16 + 32 = 62。 下表列出星期幾的值。

Description
1 星期日
2 星期一
4 Tuesday
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 Agent 會從星期一到星期五從上午 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