sysmail_configure_sp (Transact-SQL)

適用対象:SQL Server

データベース メールの構成設定を変更します。 指定された 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 (失敗)。

結果セット

ありません。

解説

データベース メールでは次のパラメーターが使用されます。

パラメーター名	説明	規定値
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';

関連するコンテンツ

• データベース メール
• sysmail_help_configure_sp (Transact-SQL)
• データベース メール ストアド プロシージャ (Transact-SQL)