sysmail_help_principalprofile_sp (Transact-SQL)
適用対象: 
SQL サーバー
データベース メール プロファイルと msdb データベース プリンシパルとの関連付けに関する情報を表示します。
構文
sysmail_help_principalprofile_sp [ { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ]
[ [ , ] { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ]
[ ; ]
引数
[ @principal_id = ] principal_id
関連付けを一覧表示する msdb データベースのデータベース ユーザーまたはロールの ID。 @principal_id は int で、既定値は NULL です。 @principal_idまたは@principal_nameを指定する必要があります。
[ @principal_name = ] 'principal_name'
関連付けを一覧表示する msdb データベースのデータベース ユーザーまたはロールの名前。 @principal_name は sysname で、既定値は NULL です。 @principal_idまたは@principal_nameを指定する必要があります。
[ @profile_id = ] profile_id
一覧表示する関連付けのプロファイルの ID。 @profile_id は int で、既定値は NULL です。 @profile_idまたは@profile_nameを指定できます。
[ @profile_name = ] 'profile_name'
一覧表示する関連付けのプロファイルの名前。 @profile_name は sysname で、既定値は NULL です。 @profile_idまたは@profile_nameを指定できます。
リターン コードの値
0 (成功) または 1 (失敗)。
結果セット
返される結果セットには、次の表に示す列が含まれています。
| 列名 | データ型 | 説明 |
|---|---|---|
principal_id |
int | データベース ユーザーの ID |
principal_name |
sysname | データベース ユーザーの名前。 |
profile_id |
int | データベース メール プロファイルの ID 番号。 |
profile_name |
sysname | データベース メール プロファイルの名前。 |
is_default |
bit | このプロファイルがユーザーの既定のプロファイルかどうかを示すフラグ |
解説
パラメーターなしで sysmail_help_principalprofile_sp 呼び出された場合、返される結果セットには、SQL Server インスタンス内のすべての関連付けが一覧表示されます。 それ以外の場合、結果セットには、指定されたパラメーターと一致する関連付けの情報が含まれます。 たとえば、プロファイル名が指定されている場合、プロシージャにはプロファイルのすべての関連付けが一覧表示されます。
sysmail_help_principalprofile_sp は msdb データベースにあり、 dbo スキーマによって所有されています。 現在のデータベースが msdbされていない場合は、プロシージャを 3 部構成の名前で実行する必要があります。
アクセス許可
このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTEアクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。
例
A. 特定の関連付けの情報を一覧表示する
次の例では、AdventureWorks Administrator データベース内の ApplicationLogin プロファイルと msdb プリンシパルのすべての関連付けについて、その情報を表示します。
EXEC msdb.dbo.sysmail_help_principalprofile_sp
@principal_name = 'danw',
@profile_name = 'AdventureWorks Administrator';
行の長さのために再フォーマットされたサンプル結果セットを次に示します。
principal_id principal_name profile_id profile_name is_default
------------ ------------------ ----------- ------------------------------ ----------
5 danw 9 AdventureWorks Administrator 1
B. すべての関連付けの情報を一覧表示する
次の例では、インスタンス内のすべての関連付けについての情報を表示します。
EXEC msdb.dbo.sysmail_help_principalprofile_sp;
行の長さのために再フォーマットされたサンプル結果セットを次に示します。
principal_id principal_name profile_id profile_name is_default
------------ ------------------ ----------- ------------------------------ ----------
6 terrid 3 Product Update Profile 1
5 danw 9 AdventureWorks Administrator 1