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

結果セット

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

列名 データ型 説明
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

関連するコンテンツ