Share via

sysmail_help_principalprofile_sp (Transact-SQL)

  • [アーティクル]

更新 : 2006 年 12 月 12 日

データベース メール プロファイルと 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。public ロールの場合は 0 を指定します。principal_id のデータ型は int で、既定値は NULL です。principal_id または principal_name のいずれかを指定できます。
  • [ @principal_name= ] 'principal_name'
    msdb データベース ユーザーの名前。public ロールの場合は 'public' を指定します。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 つの要素を指定する必要があります。

権限

sysadmin 固定サーバー ロールのメンバシップが必要です。

例

A. 特定の関連付けについての情報を表示する

次の例では、msdb データベース内の AdventureWorks Administrator プロファイルと ApplicationLogin プリンシパルのすべての関連付けについて、その情報を表示します。

EXECUTE 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. すべての関連付けについての情報を表示する

次の例では、インスタンス内のすべての関連付けについての情報を表示します。

EXECUTE 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

参照

関連項目

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

その他の技術情報

データベース メール
[構成タスクの選択] (データベース メール)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース 履歴

2006 年 12 月 12 日
変更内容 :
  • msdb ユーザーであり、そのロールが public ロールに限定される場合の指定方法を追加しました。

2006 年 4 月 14 日
変更内容 :
  • 存在しない @database_id パラメータと @database_name パラメータを削除しました。