sysmail_configure_sp (Transact-SQL)

  • 發行項

適用於：SQL Server

變更 Database Mail 的組態設定。 指定的 sysmail_configure_sp 組態設定會套用至整個 SQL Server 實例。

Transact-SQL 語法慣例

語法

sysmail_configure_sp [ [ @parameter_name = ] 'parameter_name' ]
    [ , [ @parameter_value = ] 'parameter_value' ]
    [ , [ @description = ] 'description' ]
[ ; ]

引數

[ @parameter_name = ] 'parameter_name'

要變更的參數名稱。

[ @parameter_value = ] 'parameter_value'

參數的新值。

[ @description = ] 'description'

參數的描述。

傳回碼值

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

結果集

無。

備註

Database Mail 使用下列參數：

參數名稱 描述 預設值
AccountRetryAttempts 外部郵件處理序嘗試利用指定設定檔中的每個帳戶來傳送電子郵件訊息的次數。 1
AccountRetryDelay 外部郵件進程在嘗試傳送郵件之間等候的時間量，以秒為單位。 5000
DatabaseMailExeMinimumLifeTime 外部郵件處理序維持使用中的最短時間 (以秒為單位)。 當 Database Mail 傳送許多訊息時，請增加此值，讓 Database Mail 保持作用中，並避免頻繁啟動和停止的額外負荷。 600
DefaultAttachmentEncoding 電子郵件附件的預設編碼方式。 MIME
MaxFileSize 附件的大小上限 (以位元組為單位)。 1000000
ProhibitedExtensions 無法作為電子郵件訊息附件來傳送的副檔名清單 (以逗號分隔)。 exe,dll,vbs,js
LoggingLevel 指定哪些訊息要記錄在 Database Mail 記錄中。 下列其中一個數值：

1 - 這是一般模式。 只會記錄錯誤。

2 - 這是擴充模式。 記錄錯誤、警告和參考訊息。

3 - 這是詳細資訊模式。 記錄錯誤、警告、資訊訊息、成功訊息和其他內部訊息。 使用此模式進行疑難解答。		 2

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

權限

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

範例

A. 設定 Database Mail 以重試每個帳戶 10 次

下列範例顯示將 Database Mail 設定為重試每個帳戶 10 次，再將帳戶視為無法連線。

EXEC msdb.dbo.sysmail_configure_sp
    'AccountRetryAttempts', '10';

B. 將附件大小上限設定為 2 MB

下列範例顯示將附件大小上限設定為 2 MB。

EXEC msdb.dbo.sysmail_configure_sp
    'MaxFileSize', '2097152';

相關內容