sysmail_help_principalprofile_sp (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,则该过程必须使用由三部分构成的名称执行。
权限
要求具有 sysadmin 固定服务器角色的成员身份。
示例
列出特定关联的信息
以下示例显示如何列出 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
列出所有关联的信息
以下示例显示如何列出该实例中所有关联的信息。
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