適用於:SQL Server
Azure SQL 受控執行個體
建立操作員 (通知收件者) 以搭配警示和作業使用。
語法
dbo.sp_add_operator
[ @name = ] N'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 = ] N'category_name' ]
[ ; ]
引數
[ @name = ] N'名稱'
操作員的名稱(通知收件者)。 此名稱必須是唯一的,且不能包含百分比 (%) 字元。
@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
注意
您必須使用 Database Mail 的電子郵件位址。
[ @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:00,且必須使用 表單HHmmss輸入 。
[ @weekday_pager_end_time = ] weekday_pager_end_time
SQL Server 代理服務不再向操作員發送呼叫器通知的結束時間,時間為週一至週五。
@weekday_pager_end_time 為 int,預設為 180000,表示24小時制的下午6:00,必須使用表格 HHmmss輸入。
[ @saturday_pager_start_time = ] saturday_pager_start_time
SQL Server 代理服務在週六開始的時間,當 SQL Server 代理服務向操作員發送分頁器通知時。
@saturday_pager_start_time 為 int,預設為 090000,表示 24 小時制的上午 9:00,必須使用表格 HHmmss輸入。
[ @saturday_pager_end_time = ] saturday_pager_end_time
在週六結束的時間,因為 SQL Server 代理服務不再向操作員發送分頁通知。
@saturday_pager_end_time為 int,預設值180000為 ,表示下午 24 小時制的下午 6:00,且必須使用 表單HHmmss輸入 。
[ @sunday_pager_start_time = ] sunday_pager_start_time
星期日開始時間,SQL Server 代理服務會向操作員發送呼叫器通知。
@sunday_pager_start_time為 int,預設值090000為 ,表示 24 小時制的上午 9:00,且必須使用 表單HHmmss輸入 。
[ @sunday_pager_end_time = ] sunday_pager_end_time
在 SQL Server 代理服務不再向操作員發送分頁器通知的星期天結束時間。
@sunday_pager_end_time為 intHHmmss
[ @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 = ] N'category_name'
這個運算子的類別名稱。
@category_name為 sysnameNULL。
若此值為 NULL,則該運算子會加上預設類別 。[Uncategorized] 你也可以從現有的類別中選擇,透過查詢 syscategories 資料庫中的 msdb 表格:
SELECT name
FROM msdb.dbo.syscategories;
傳回碼值
0 (成功) 或 1 (失敗)。
結果集
無。
備註
sp_add_operator 必須從 msdb 資料庫執行。
如果您想要使用分頁,您的電子郵件系統必須具有電子郵件到呼叫器功能。
SQL Server Management Studio 提供易用的作業管理圖形介面,是建立及管理作業基礎結構的建議方式。
權限
您可以授與此 EXECUTE 程序的許可權,但這些許可權可能會在 SQL Server 升級期間覆寫。
範例
下列範例會設定的 danwi運算符資訊。 運算子已啟用。 SQL Server Agent 會從星期一到星期五從上午 8 點到下午 5 點,依呼叫器傳送通知。
USE msdb;
GO
EXECUTE 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