sysmail_add_account_sp （Transact-SQL）

  • 發行項

適用於：SQL ServerAzure SQL 受控執行個體

建立新的 Database Mail 帳戶，其中包含 SMTP 帳戶的相關信息。

Transact-SQL 語法慣例

語法

sysmail_add_account_sp [ @account_name = ] 'account_name' ,
    [ @email_address = ] 'email_address' ,
    [ [ @display_name = ] 'display_name' , ]
    [ [ @replyto_address = ] 'replyto_address' , ]
    [ [ @description = ] 'description' , ]
    [ @mailserver_name = ] 'server_name'
    [ , [ @mailserver_type = ] 'server_type' ]
    [ , [ @port = ] port_number ]
    [ , [ @username = ] 'username' ]
    [ , [ @password = ] 'password' ]
    [ , [ @use_default_credentials = ] use_default_credentials ]
    [ , [ @enable_ssl = ] enable_ssl ]
    [ , [ @account_id = ] account_id OUTPUT ]
[ ; ]

引數

[ @account_name = ] 'account_name'

要加入的帳戶名稱。 @account_name為 sysname，沒有預設值。

[ @email_address = ] 'email_address'

要傳送訊息的電子郵件位址。 此位址必須是因特網電子郵件位址。 @email_address為 nvarchar（128），沒有預設值。 例如，SQL Server Agent 的帳戶可能會從位址 SqlAgent@adventure-works.com傳送電子郵件。

[ @display_name = ] 'display_name'

要用於此帳戶之電子郵件訊息的顯示名稱。 @display_name為 nvarchar（128），預設值為 NULL。 例如，SQL Server Agent 的帳戶可能會在電子郵件訊息上顯示名稱 SQL Server Agent Automated Mailer 。

[ @replyto_address = ] 'replyto_address'

從此帳號回應訊息的位址會傳送至 。 @replyto_address為 nvarchar（128），預設值為 NULL。 例如，回復 SQL Server Agent 的帳戶可能會前往資料庫管理員 danw@adventure-works.com。

[ @description = ] 'description'

帳戶的描述。 @description為 nvarchar（256），預設值為 NULL。

[ @mailserver_name = ] 'server_name'

要用於此帳戶之 SMTP 郵件伺服器的名稱或 IP 位址。 執行 SQL Server 的電腦必須能夠將 @mailserver_name 解析為 IP 位址。 @mailserver_name為 sysname，沒有預設值。

[ @mailserver_type = ] 'server_type'

電子郵件伺服器的類型。 @mailserver_type為 sysname 預設值為 SMTP。

[ @port = ] port_number

電子郵件伺服器的埠號碼。 @port為 int，預設值為 25。

[ @username = ] 'username'

用來登入電子郵件伺服器的用戶名稱。 @username為 nvarchar（128），預設值為 NULL。 當此參數為 NULL時，Database Mail 不會針對此帳戶使用驗證。 如果郵件伺服器不需要驗證，請使用 NULL 用戶名稱。

[ @password = ] 'password'

用來登入電子郵件伺服器的密碼。 @password為 nvarchar（128），預設值為 NULL。 除非指定使用者名稱，否則不需要提供密碼。

[ @use_default_credentials = ] use_default_credentials

指定是否使用 SQL Server 資料庫引擎 的認證，將郵件傳送至 SMTP 伺服器。 @use_default_credentials為 bit，預設值為 0。 當此參數為 1時，Database Mail 會使用 資料庫引擎 的認證。 當此參數為 0時，Database Mail 會在存在時傳送 @username 和 @password 參數，否則會傳送不含 @username 和 @password 參數的郵件。

[ @enable_ssl = ] enable_ssl

指定 Database Mail 是否使用安全套接字層加密通訊。 @enable_ssl為 bit，預設值為 0。

[ @account_id = ] account_id OUTPUT

傳回新帳戶的帳戶標識碼。 @account_id 為 int，預設值為 NULL。

傳回碼值

0 （成功）或 1 （失敗）。

備註

Database Mail 為@email_address、@display_name和@replyto_address提供個別的參數。 @email_address參數是訊息傳送的來源位址。 @display_name參數是電子郵件訊息欄位中顯示From:的名稱。 @replyto_address參數是將傳送電子郵件訊息回復的位址。 例如，用於 SQL Server Agent 的帳戶可能會從只用於 SQL Server Agent 的電子郵件地址傳送電子郵件訊息。 來自該位址的郵件應該會顯示易記名稱，因此收件者可以輕鬆地判斷 SQL Server Agent 傳送郵件。 如果收件者回復郵件，回復應該會移至資料庫管理員，而不是 SQL Server Agent 所使用的位址。 在此案例中，帳戶會使用 SqlAgent@adventure-works.com 作為電子郵件位址。 顯示名稱會設定為 SQL Server Agent Automated Mailer。 此帳戶會使用 danw@adventure-works.com 作為地址的回復，因此回復從此帳戶傳送的郵件會移至資料庫管理員，而不是 SQL Server Agent 的電子郵件位址。 Database Mail 提供這三個參數的獨立設定，可讓您設定訊息以符合您的需求。

@mailserver_type參數支援 值 SMTP。

當 @use_default_credentials 為 1時，會使用 SQL Server 資料庫引擎 的認證，將郵件傳送至 SMTP 伺服器。 當 @use_default_credentials 為 0 ，且 針對帳戶指定了@username 和 @password 時，帳戶會使用 SMTP 驗證。 @username和@password是帳戶用於 SMTP 伺服器的認證，而不是 SQL Server 的認證或電腦所開啟的網路認證。

預存程式 sysmail_add_account_sp 位於 msdb 資料庫中，而且是由 dbo 架構所擁有。 如果目前的資料庫不是 msdb，則必須使用三部分名稱執行程式。

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權，但這些許可權可能會在 SQL Server 升級期間覆寫。

範例

下列範例會建立名為的 AdventureWorks Administrator帳戶。 此帳號會使用電子郵件位址 dba@adventure-works.com ，並將郵件傳送至 SMTP 郵件伺服器 smtp.adventure-works.com。 從此帳戶傳送的電子郵件訊息會顯示 AdventureWorks Automated Mailer 在 From: 郵件行上。 回覆訊息會導向至 danw@adventure-works.com。

EXEC msdb.dbo.sysmail_add_account_sp
    @account_name = 'AdventureWorks Administrator',
    @description = 'Mail account for administrative e-mail.',
    @email_address = 'dba@adventure-works.com',
    @display_name = 'AdventureWorks Automated Mailer',
    @mailserver_name = 'smtp.adventure-works.com';

相關內容