sysmail_help_configure_sp (Transact-SQL)

データベース メールの構成設定を表示します。

Transact-SQL 構文表記規則

構文

sysmail_help_configure_sp  [ [ @parameter_name = ] 'parameter_name' ]

引数

• [@parameter_name = ] 'parameter_name'
  取得する構成設定の名前を指定します。 指定すると、構成設定の値が @parameter_value OUTPUT パラメーターに返されます。 @parameter_name を指定しないと、このストアド プロシージャでは、インスタンス内のすべてのデータベース メール構成設定を含む結果セットが返されます。

戻り値

0 (成功) または 1 (失敗)

結果セット

@parameter_name を指定しない場合は、次の列を含む結果セットが返されます。

列名	データ型	説明
paramname	nvarchar(256)	構成パラメーターの名前
paramvalue	nvarchar(256)	構成パラメーターの値
description	nvarchar(256)	構成パラメーターの説明

説明

ストアド プロシージャ sysmail_help_configure_sp では、インスタンスに対する現在のデータベース メールの構成設定が一覧表示されます。

@parameter_name を指定しても、@parameter_value に出力パラメーターが提供されなかった場合、このストアド プロシージャでは何も出力されません。

ストアド プロシージャ sysmail_help_configure_sp は msdb データベースにあり、dbo スキーマが所有しています。 現在のデータベースが msdb でない場合、このプロシージャを実行するときには名前に 3 つの要素を指定する必要があります。

権限

このプロシージャの実行権限は、既定では sysadmin 固定サーバー ロールのメンバーに与えられています。

使用例

次の例では、SQL Server インスタンスに対するデータベース メールの構成設定を一覧表示します。

EXECUTE msdb.dbo.sysmail_help_configure_sp ;

次に結果セットを示します。行の長さは調整されています。

paramname                       paramvalue      description
------------------------------- --------------- -----------------------------------------------------------------------------
AccountRetryAttempts            1               Number of retry attempts for a mail server
AccountRetryDelay               5000            Delay between each retry attempt to mail server
DatabaseMailExeMinimumLifeTime  600             Minimum process lifetime in seconds
DefaultAttachmentEncoding       MIME            Default attachment encoding
LoggingLevel                    2               Database Mail logging level: normal - 1, extended - 2 (default), verbose - 3
MaxFileSize                     1000000         Default maximum file size
ProhibitedExtensions            exe,dll,vbs,js  Extensions not allowed in outgoing mails

関連項目

参照

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

概念

データベース メール