sysmail_help_account_sp (Transact-SQL)
Предоставляет сведения (за исключением паролей) об учетных записях компонента Database Mail.
.gif "Значок ссылки на раздел")
Синтаксис
sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]
Аргументы
[ @account_id = ] account_id
Идентификатор учетной записи, о которой предоставляются сведения. Аргумент account_id имеет тип int и значение по умолчанию NULL.[ @account_name = ] 'account_name'
Имя учетной записи, о которой предоставляются сведения. Аргумент account_name имеет тип sysname и значение по умолчанию NULL.
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Результирующие наборы
Возвращает результирующий набор, содержащий столбцы перечисленные ниже.
Имя столбца |
Тип данных |
Описание |
account_id |
int |
Идентификатор учетной записи. |
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, компонент Database Mail не использует проверку подлинности для этой учетной записи. |
use_default_credentials |
bit |
Указывает, посылать ли почту серверу SMTP с помощью учетных данных компонента SQL Server Database Engine. Параметр use_default_credentials имеет тип bit и не имеет значения по умолчанию. Если этот параметр равен 1, компонент Database Mail использует учетные данные службы компонента SQL Server Database Engine. Если этот параметр равен 0, компонент Database Mail использует параметры @username и @password для проверки подлинности на SMTP-сервере. Если значения параметров @username и @password равны NULL, компонент Database Mail использует анонимную проверку подлинности. Перед указанием этого параметра проконсультируйтесь с администратором SMTP-сервера. |
enable_ssl |
bit |
Указывает, шифрует ли компонент Database Mail соединение с помощью протокола SSL. Используйте этот параметр в случае, если на SMTP-сервере необходим протокол SSL. Параметр enable_ssl имеет тип bit и не имеет значения по умолчанию. Значение 1 означает, что компонент Database Mail шифрует соединение при помощи протокола SSL. Значение 0 означает, что компонент Database Mail посылает электронную почту без шифрования при помощи протокола SSL. |
Замечания
Если аргумент account_id или аргумент account_name не указывается, функция sysmail_help_account предоставляет данные для всех учетных записей компонента Database Mail на экземпляре Microsoft SQL Server.
Хранимая процедура sysmail_help_account_sp находится в базе данных msdb и принадлежит схеме dbo. Если текущей базой данных является не msdb, процедуру следует выполнять с трехкомпонентным именем.
Разрешения
По умолчанию разрешения на выполнение этой процедуры имеют члены предопределенной роли сервера sysadmin.
Примеры
А. Вывод сведений обо всех учетных записях
На следующем примере показано, как выводятся сведения обо всех учетных записях в экземпляре.
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
Б. Вывод сведений об указанной учетной записи
На следующем примере показано, как выводятся сведения об учетной записи с именем 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
См. также