• 项目

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 数据库中 AdventureWorks2008R2 Administrator 配置文件和 ApplicationLogin 主体之间的所有关联的信息。

EXECUTE msdb.dbo.sysmail_help_principalprofile_sp
    @principal_name = 'danw',
    @profile_name = 'AdventureWorks2008R2 Administrator' ;

下面是行长度经过调整的示例结果集。

principal_id principal_name     profile_id  profile_name                   is_default
------------ ------------------ ----------- ------------------------------ ----------
5            danw               9           AdventureWorks2008R2 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           AdventureWorks2008R2 Administrator   1