sp_add_operator （Transact-SQL）

  • 發行項

適用於：SQL ServerAzure 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.bregu 或 fatmir.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表示運算符永遠無法接收頁面。 有效值是從 0 到 127。 @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

相關內容