sysmail_help_principalprofile_sp (Transact-SQL)

適用対象: SQL Server

データベース メール プロファイルと msdb データベース プリンシパルとの関連付けに関する情報を表示します。

Transact-SQL 構文表記規則

構文

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 (失敗)。

結果セット

返される結果セットには、次の表に示す列が含まれています。

解説

パラメーターなしで sysmail_help_principalprofile_sp 呼び出された場合、返される結果セットには、SQL Server インスタンス内のすべての関連付けが一覧表示されます。 それ以外の場合、結果セットには、指定されたパラメーターと一致する関連付けの情報が含まれます。 たとえば、プロファイル名が指定されている場合、プロシージャにはプロファイルのすべての関連付けが一覧表示されます。

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

アクセス許可

この手順では 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

関連するコンテンツ

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