sp_notify_operator (Transact-SQL)
更新： 2006 年 7 月 17 日
利用 Database Mail 將電子郵件訊息傳送給操作員。
語法
sp_notify_operator
[ @profile_name = ] 'profilename' ,
[ @id = ] id ,
[ @name = ] 'name' ,
[ @subject = ] 'subject' ,
[ @body = ] 'message' ,
[ @file_attachments = ] 'attachment'
[ @mail_database = ] 'mail_host_database'
引數
- [ @profile_name= ] 'profilename'
用來傳送訊息的 Database Mail 設定檔名稱。profilename 是 nvarchar(128)。如果未指定 profilename，則使用預設 Database Mail 設定檔。
- [ @id= ] id
這是訊息所要送往的操作員識別碼。id 是 int，預設值是 NULL。您必須指定 id 或 name 其中之一。
[ @name= ] 'name'
這是訊息所要送往的操作員名稱。name 是 nvarchar(128)，預設值是 NULL。您必須指定 id 或 name 其中之一。.gif "ms188349.note(zh-tw,SQL.90).gif")
附註：您必須先定義好操作員的電子郵件地址，他們才能接收訊息。
- [ @subject= ] 'subject'
電子郵件訊息的主旨。subject 是 nvarchar(256)，沒有預設值。
- [ @body= ] 'message'
電子郵件訊息的主體。message 是 nvarchar(max)，沒有預設值。
- [ @file_attachments= ] 'attachment'
這是要附加至電子郵件訊息的檔案名稱。attachment 是 nvarchar(512)，沒有預設值。
- [ @mail_database= ] 'mail_host_database'
指定郵件主機資料庫的名稱。mail_host_database 是 nvarchar(128)。如果未指定任何 mail_host_database，依預設，會使用 msdb 資料庫。
傳回碼值
0 (成功) 或 1 (失敗)
備註
將指定的訊息傳送給指定操作員的電子郵件地址。如果未設定操作員的電子郵件地址，就會傳回錯誤。
您必須先設定好 Database Mail 和郵件主機資料庫，才能將通知傳給操作員。如需詳細資訊，請參閱＜Database Mail 的如何主題＞。
權限
依預設，只有系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行這個預存程序。其他使用者必須被授與 msdb 資料庫的下列其中一個 SQL Server Agent 固定資料庫角色。
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
如需有關這些角色權限的詳細資料，請參閱＜SQL Server Agent 固定資料庫角色＞。
範例
下列範例會利用 AdventureWorks Administrator Database Mail 設定檔，將通知電子郵件傳給 François Ajenstat 操作員。電子郵件的主旨是 Test Notification。電子郵件訊息包含 "This is a test of notification via e-mail." 這個句子。
USE msdb ;
GO
EXEC dbo.sp_notify_operator
@profile_name = N'AdventureWorks Administrator',
@name = N'François Ajenstat',
@subject = N'Test Notification',
@body = N'This is a test of notification via e-mail.' ;
GO
請參閱
參考
sp_add_operator (Transact-SQL)
sp_help_operator (Transact-SQL)
sp_delete_operator (Transact-SQL)
說明及資訊
變更歷程記錄
| 版本 | 歷程記錄 |
|---|---|
2006 年 7 月 17 日 |
|
2006 年 4 月 14 日 |
|