• 项目

sysmail_help_account_sp (Transact-SQL)

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

主题链接图标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         AdventureWorks2008R2 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 = 'AdventureWorks2008R2 Administrator' ;

下面是示例结果集，由于行的长度原因而进行了编辑：

account_id  name                         description                             email_address             display_name                     replyto_address servertype servername                port        username use_default_credentials enable_ssl
----------- ---------------------------- ------------------------------------------------------ ------------------------- ---------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148         AdventureWorks2008R2 Administrator Mail account for administrative e-mail. dba@Adventure-Works.com   AdventureWorks Automated Mailer  NULL            SMTP       smtp.Adventure-Works.com  25          NULL     0                       0