sysmail_help_profile_sp (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

1 つ以上のメール プロファイルに関する情報を一覧表示します。

Transact-SQL 構文表記規則

構文

sysmail_help_profile_sp [ [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' ]
[ ; ]

引数

[ @profile_id = ] profile_id

情報を返すプロファイル ID。 @profile_idは int で、既定値は NULL.

[ @profile_name = ] 'profile_name'

情報を返すプロファイル名。 @profile_nameは sysname で、既定値は NULL.

リターン コードの値

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

結果セット

次の列を含む結果セットが返されます。

列名 データ型 説明
profile_id int プロファイルのプロファイル ID。
name sysname プロファイルのプロファイル名。
description nvarchar (256) プロファイルの説明。

解説

プロファイル名またはプロファイル ID を指定すると、 sysmail_help_profile_sp そのプロファイルに関する情報が返されます。 それ以外の場合は、 sysmail_help_profile_sp SQL Server インスタンス内のすべてのプロファイルに関する情報を返します。

ストアド プロシージャsysmail_help_profile_spはデータベース内msdbにあり、dbo スキーマによって所有されています。 現在のデータベースが実行されていない msdb場合は、プロシージャを 3 部構成の名前で実行する必要があります。

アクセス許可

このストアド プロシージャは、db_owner ロールによって所有されています。 任意のユーザーにアクセス許可を付与 EXECUTE できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

例

A. すべてのプロファイルを一覧表示する

次の例は、インスタンス内のすべてのプロファイルの一覧を示しています。

EXEC msdb.dbo.sysmail_help_profile_sp;

行の長さのために再フォーマットされたサンプル結果セットを次に示します。

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.
57          AdventureWorks Operator       Operator mail profile.

B. 特定のプロファイルを一覧表示する

次の例では、プロファイル AdventureWorks Administrator に関する情報を一覧表示します。

EXEC msdb.dbo.sysmail_help_profile_sp
    @profile_name = 'AdventureWorks Administrator' ;

行の長さのために再フォーマットされたサンプル結果セットを次に示します。

profile_id  name                          description
----------- ----------------------------- ------------------------------
56          AdventureWorks Administrator  Administrative mail profile.

関連するコンテンツ