sysmail_help_account_sp (Transact-SQL)
列出有关数据库邮件帐户的信息(密码除外)。
语法
sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]
参数
- [ @account_id = ] account_id
列出其帐户信息的帐户的 ID。account_id 的数据类型为 int,默认值为 NULL。
- [ @account_name = ] 'account_name'
列出其帐户信息的帐户的名称。account_name 的数据类型为 sysname,默认值为 NULL。
返回代码值
0(成功)或 1(失败)
结果集
返回包含下面列出的列的结果集。
列名 |
数据类型 |
说明 |
account_id |
int |
帐户 ID。 |
name |
sysname |
帐户名称。 |
description |
nvarchar(256) |
对帐户的说明。 |
email_address |
nvarchar(128) |
发送消息的电子邮件地址。 |
display_name |
nvarchar(128) |
帐户的显示名称。 |
replyto_address |
nvarchar(128) |
对于来自此帐户的消息发送答复的地址。 |
servertype |
sysname |
用于此帐户的电子邮件服务器的类型。 |
servername |
sysname |
用于此帐户的电子邮件服务器的名称。 |
port |
int |
电子邮件服务器使用的端口号。 |
username |
nvarchar(128) |
登录电子邮件服务器所用的用户名(如果电子邮件服务器使用身份验证)。当 username 为 NULL 时,数据库邮件不对此帐户使用身份验证。 |
use_default_credentials |
bit |
指定是否使用 SQL Server 数据库引擎的凭据向 SMTP 服务器发送邮件。use_default_credentials 的数据类型为 bit,无默认值。当此参数为 1 时,数据库邮件使用 SQL Server 数据库引擎服务的凭据。当此参数为 0 时,数据库邮件使用 @username 和 @password 在 SMTP 服务器中进行身份验证。如果 @username 和 @password 为 NULL,则数据库邮件使用匿名身份验证。在指定此参数之前,请咨询您的 SMTP 管理员。 |
enable_ssl |
bit |
指定数据库邮件是否使用安全套接字层 (SSL) 对通信进行加密。如果 SMTP 服务器需要 SSL,则使用该选项。enable_ssl 的数据类型为 bit,无默认值。1 指示数据库邮件使用 SSL 对通信进行加密。0 指示数据库邮件发送未使用 SSL 进行加密的邮件。 |
备注
如果未提供 account_id 或 account_name,则 sysmail_help_account 将列出有关 Microsoft SQL Server 实例中所有数据库邮件帐户的信息。
存储过程 sysmail_help_account_sp 位于 msdb 数据库,属于 dbo 架构。如果当前数据库不是 msdb,则该过程必须使用由三部分组成的名称执行。
权限
此过程的执行权限默认授予 sysadmin 固定服务器角色的成员。
示例
A. 列出所有帐户的信息
以下示例列出该实例所有帐户的帐户信息。
EXECUTE msdb.dbo.sysmail_help_account_sp ;
下面是示例结果集,由于行的长度原因而进行了编辑:
account_id name description email_address display_name replyto_address servertype servername port username use_default_credentials enable_ssl
----------- ---------------------------- --------------------------------------- ------------------------- -------------------------------- --------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148 AdventureWorks Administrator Mail account for administrative e-mail. dba@Adventure-Works.com AdventureWorks Automated Mailer NULL SMTP smtp.Adventure-Works.com 25 NULL 0 0
149 Audit Account Account for audit e-mail. audit@Adventure-Works.com Automated Mailer (Audit) NULL SMTP smtp.Adventure-Works.com 25 NULL 0 0
B. 列出特定帐户的信息
以下示例列出名为 AdventureWorks Administrator
的帐户信息。
EXECUTE msdb.dbo.sysmail_help_account_sp
@account_name = 'AdventureWorks Administrator' ;
下面是示例结果集,由于行的长度原因而进行了编辑:
account_id name description email_address display_name replyto_address servertype servername port username use_default_credentials enable_ssl
----------- ---------------------------- ------------------------------------------------------ ------------------------- ---------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148 AdventureWorks Administrator Mail account for administrative e-mail. dba@Adventure-Works.com AdventureWorks Automated Mailer NULL SMTP smtp.Adventure-Works.com 25 NULL 0 0
请参阅
参考
数据库邮件和 SQL 邮件存储过程 (Transact-SQL)
其他资源
数据库邮件
数据库邮件配置向导
选择配置任务(数据库邮件)
数据库邮件帐户