sysmail_help_principalprofile_sp (Transact-SQL)
适用范围:SQL Server
列出有关数据库邮件配置文件和数据库主体之间的关联的信息。
语法
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
,则必须使用三部分名称执行该过程。
权限
此存储过程由 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