sysmail_help_principalprofile_sp (Transact-SQL)

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

主题链接图标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