sysmail_help_account_sp (Transact-SQL)
Область применения: SQL Server
Предоставляет сведения (за исключением паролей) об учетных записях компонента Database Mail.
Соглашения о синтаксисе Transact-SQL
Синтаксис
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
(сбой).
Результирующий набор
Возвращает результирующий набор, содержащий столбцы перечисленные ниже.
Имя столбца | Тип данных | Description |
---|---|---|
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. Если этот параметр задан1 , Database Mail использует учетные данные службы sql Server ядро СУБД. Если этот параметр задан 0 , Database Mail использует @username и @password для проверки подлинности на SMTP-сервере. Если @username и @password имеют значение NULL, database Mail использует анонимную проверку подлинности. Перед указанием этого параметра обратитесь к администратору SMTP. |
enable_ssl |
bit | Указывает, шифрует ли database Mail обмен данными с помощью протокола TLS, ранее известного как протокол SSL. Используйте этот параметр, если на SMTP-сервере требуется tls. 1 указывает, что Database Mail шифрует обмен данными с помощью TLS. Значение 0 указывает, что компонент Database Mail отправляет почту без шифрования TLS. |
Замечания
Если account_id или account_name не предоставляется, sysmail_help_account
выводится информация обо всех учетных записях Database Mail в экземпляре Microsoft SQL Server.
Хранимая процедура sysmail_help_account_sp
находится в msdb
базе данных и принадлежит схеме dbo . Процедура должна выполняться с трехкомпонентным именем, если текущая база данных не msdb
является.
Разрешения
Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE
разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.
Примеры
А. Список сведений для всех учетных записей
На следующем примере показано, как выводятся сведения обо всех учетных записях в экземпляре.
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