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 其中之一。

  附註：
  您必須先定義好操作員的電子郵件地址，他們才能接收訊息。

• [ @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)

說明及資訊

取得 SQL Server 2005 協助

變更歷程記錄

版本	歷程記錄
2006 年 7 月 17 日	變更的內容： 將範例中的引數名稱 @profilename 更新為 @profile_name。
2006 年 4 月 14 日	變更的內容： 將引數名稱 @profilename 更新為 @profile_name，並將資料類型從 sysname 變更為 nvarchar(128)。 將 @name 的資料類型從 sysname 變更為 nvarchar(128)。