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_spmsdb データベースにあり、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