sysmail_configure_sp (Transact-SQL)
適用対象: 
SQL サーバー
データベース メールの構成設定を変更します。 sysmail_configure_sp指定された構成設定は、SQL Server インスタンス全体に適用されます。
構文
sysmail_configure_sp [ [ @parameter_name = ] 'parameter_name' ]
[ , [ @parameter_value = ] 'parameter_value' ]
[ , [ @description = ] 'description' ]
[ ; ]
引数
[ @parameter_name = ] 'parameter_name'
変更するパラメーターの名前。
[ @parameter_value = ] 'parameter_value'
パラメーターの新しい値を指定します。
[ @description = ] '説明'
パラメーターの説明。
リターン コードの値
0 (成功) または 1 (失敗)。
結果セット
ありません。
解説
データベース メールでは次のパラメーターが使用されます。
| パラメーター名 | 説明 | 規定値 |
|---|---|---|
AccountRetryAttempts |
指定したプロファイル内の各アカウントを使用して、外部メール処理が電子メール メッセージの送信を試行する回数。 | 1 |
AccountRetryDelay |
外部メール処理が次回のメッセージ送信の試行を待機する時間 (秒単位)。 | 5000 |
DatabaseMailExeMinimumLifeTime |
外部メール処理がアクティブな状態にとどまる最小時間 (秒単位)。 データベース メールが多数のメッセージを送信している場合は、この値を大きくしてデータベース メールアクティブな状態を維持し、頻繁な開始と停止のオーバーヘッドを回避します。 | 600 |
DefaultAttachmentEncoding |
電子メールの添付ファイルの既定のエンコード。 | MIME |
MaxFileSize |
添付ファイルの最大サイズ (バイト単位)。 | 1000000 |
ProhibitedExtensions |
電子メールへの添付ファイルとして送信できない拡張子のコンマ区切りのリスト。 | exe,dll,vbs,js |
LoggingLevel |
データベース メール ログに記録されるメッセージ。 次のいずれかの数値。 1 - これは通常モードです。 エラーのみをログに記録します。 2 - これは拡張モードです。 エラー、警告、情報メッセージをログに記録します。 3 - これは詳細モードです。 エラー、警告、情報メッセージ、成功メッセージ、追加の内部メッセージをログに記録します。 トラブルシューティングを行うには、このモードを使用してください。 |
2 |
ストアド プロシージャ sysmail_configure_sp は msdb データベースにあり、 dbo スキーマによって所有されます。 現在のデータベースが msdbされていない場合は、プロシージャを 3 部構成の名前で実行する必要があります。
アクセス許可
このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTEアクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。
例
A. 各アカウントを 10 回再試行するようにデータベース メールを設定する
次の例は、アカウントに到達できないと見なす前に、各アカウントを 10 回再試行するようにデータベース メール設定を示しています。
EXEC msdb.dbo.sysmail_configure_sp
'AccountRetryAttempts', '10';
B. 添付ファイルの最大サイズを 2 メガバイトに設定する
次の例では、添付ファイルの最大サイズを 2 MB に設定します。
EXEC msdb.dbo.sysmail_configure_sp
'MaxFileSize', '2097152';