sysmail_help_account_sp (Transact-SQL)

适用于SQL Server

列出有关数据库邮件帐户的信息(密码除外)。

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 服务器。 如果此参数为1此参数,则数据库邮件使用 SQL Server 数据库引擎 服务的凭据。 当此参数为0此参数时,数据库邮件使用@username并在 SMTP 服务器上@password进行身份验证。 如果@username@password为 NULL,则数据库邮件使用匿名身份验证。 在指定此参数之前,请咨询 SMTP 管理员。
enable_ssl bit 指定数据库邮件是否使用传输层安全性(TLS)加密通信,以前称为安全套接字层(SSL)。 如果 SMTP 服务器上需要 TLS,请使用此选项。 1指示数据库邮件使用 TLS 加密通信。 0 表示数据库邮件发送不带 TLS 加密的邮件。

注解

如果未提供account_idaccount_namesysmail_help_account请列出有关Microsoft SQL Server 实例中所有数据库邮件帐户的信息。

存储过程 sysmail_help_account_sp 位于 msdb 数据库中,由 dbo 架构拥有。 如果当前数据库不是 msdb,则必须使用三部分名称执行该过程。

权限

此存储过程由 db_owner 角色拥有。 你可以为任何用户授予 EXECUTE 权限,但这些权限可能会在 SQL Server 升级期间被重写。

示例

A. 列出所有帐户的信息

以下示例列出该实例所有帐户的帐户信息。

EXEC 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 的帐户信息。

EXEC 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