sysmail_help_principalprofile_sp (Transact-SQL)

适用范围:SQL Server

列出有关数据库邮件配置文件和数据库主体之间的关联的信息。

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,则必须使用三部分名称执行该过程。

权限

可以授予 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