sysmail_help_principalprofile_sp (Transact-SQL)
適用対象:SQL Server
データベース メール プロファイルと 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
関連するコンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示