sysmail_help_profileaccount_sp (Transact-SQL)
列出与一个或多个数据库邮件配置文件相关联的帐户。
语法
sysmail_help_profileaccount_sp
{ [ @profile_id = ] profile_id
| [ @profile_name = ] 'profile_name' }
[ , { [ @account_id = ] account_id
| [ @account_name = ] 'account_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。[ @account_id = ] account_id
要列出的帐户 ID。account_id 的数据类型为 int,默认值为 NULL。当 account_id 和 account_name 同时为 NULL 时,则列出配置文件中的所有帐户。[ @account_name = ] 'account_name'
要列出的帐户的名称。account_name 的数据类型为 sysname,默认值是 NULL。当 account_id 和 account_name 同时为 NULL 时,则列出配置文件中的所有帐户。
返回代码值
0(成功)或 1(失败)
结果集
返回包含以下列的结果集:
列名 |
数据类型 |
描述 |
profile_id |
int |
配置文件的配置文件 ID。 |
profile_name |
sysname |
配置文件的名称。 |
account_id |
int |
帐户的帐户 ID。 |
account_name |
sysname |
帐户的名称。 |
sequence_number |
int |
配置文件中的帐户的序号。 |
注释
如果未指定 profile_id 或 profile_name,则此存储过程将返回实例中的每个配置文件的信息。
存储过程 sysmail_help_profileaccount_sp 在 msdb 数据库中,并且由 dbo 架构拥有。如果当前数据库不是 msdb,则该过程必须使用由三部分组成的名称执行。
权限
此过程的执行权限默认授予 sysadmin 固定服务器角色的成员。
示例
A. 按名称列出特定配置文件的帐户
以下示例通过指定配置文件名称以列出 AdventureWorks Administrator 配置文件的信息。
EXECUTE msdb.dbo.sysmail_help_profileaccount_sp
@profile_name = 'AdventureWorks Administrator'
下面是示例结果集,由于行的长度原因而进行了编辑:
profile_id profile_name account_id account_name sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131 AdventureWorks Administrator 197 Admin-MainServer 1
131 AdventureWorks Administrator 198 Admin-BackupServer 2
B. 按配置文件 ID 列出特定配置文件的帐户
以下示例通过指定配置文件的配置文件 ID 以列出 AdventureWorks Administrator 配置文件的信息。
EXECUTE msdb.dbo.sysmail_help_profileaccount_sp
@profile_id = 131 ;
下面是示例结果集,由于行的长度原因而进行了编辑:
profile_id profile_name account_id account_name sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131 AdventureWorks Administrator 197 Admin-MainServer 1
131 AdventureWorks Administrator 198 Admin-BackupServer 2
C. 列出所有配置文件的帐户
以下示例列出实例中的所有配置文件的帐户。
EXECUTE msdb.dbo.sysmail_help_profileaccount_sp
下面是示例结果集,由于行的长度原因而进行了编辑:
profile_id profile_name account_id account_name sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131 AdventureWorks Administrator 197 Admin-MainServer 1
131 AdventureWorks Administrator 198 Admin-BackupServer 2
106 AdventureWorks Operator 210 Operator-MainServer 1