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_id或account_name，sysmail_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

相关内容