sysmail_help_account_sp (Transact-SQL)
Aplica-se: SQL Server
Lista informações (exceto senhas) sobre contas do Database Mail.
Convenções de sintaxe de Transact-SQL
Sintaxe
sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]
[ ; ]
Argumentos
@account_id [ = ] account_id
A ID da conta para a qual as informações serão listadas. @account_id é int, com um padrão de NULL
.
@account_name [ = ] 'account_name'
O nome da conta para a qual listar informações. @account_name é sysname, com um padrão de NULL
.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Conjunto de resultados
Retorna um conjunto de resultados que contém as colunas listadas a seguir.
Nome da coluna | Tipo de dados | Descrição |
---|---|---|
account_id |
int | O ID da conta. |
name |
sysname | O nome da conta. |
description |
nvarchar(256) | A descrição da conta. |
email_address |
nvarchar(128) | O endereço de email a partir do qual as mensagens serão enviadas. |
display_name |
nvarchar(128) | O nome para exibição da conta. |
replyto_address |
nvarchar(128) | O endereço onde as respostas às mensagens desta conta são enviadas. |
servertype |
sysname | O tipo de servidor de email da conta. |
servername |
sysname | O nome do servidor de email da conta. |
port |
int | O número da porta usada pelo servidor de email. |
username |
nvarchar(128) | O nome de usuário a ser usado para fazer logon no servidor de email, se o servidor de email usar autenticação. Quando username é NULL , o Database Mail não usa autenticação para essa conta. |
use_default_credentials |
bit | Especifica se o email deve ser enviado para o servidor SMTP usando as credenciais do Mecanismo de Banco de Dados do SQL Server. Quando esse parâmetro é 1 , o Database Mail usa as credenciais do serviço Mecanismo de Banco de Dados do SQL Server. Quando esse parâmetro é 0 , o Database Mail usa o @username e o @password para autenticação no servidor SMTP. Se @username e @password forem NULL , o Database Mail usará autenticação anônima. Consulte o administrador do SMTP antes de especificar esse parâmetro. |
enable_ssl |
bit | Especifica se o Database Mail criptografa a comunicação usando o Transport Layer Security (TLS), anteriormente conhecido como Secure Sockets Layer (SSL). Use essa opção se o TLS for necessário em seu servidor SMTP. 1 indica que o Database Mail criptografa a comunicação usando TLS. 0 indica que o Database Mail envia o e-mail sem criptografia TLS. |
Comentários
Quando nenhum account_id ou account_name é fornecido, sysmail_help_account
lista informações sobre todas as contas do Database Mail na instância do Microsoft SQL Server.
O procedimento sysmail_help_account_sp
armazenado está no msdb
banco de dados e pertence ao esquema dbo . O procedimento deve ser executado com um nome de três partes se o banco de dados atual não msdb
for .
Permissões
Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE
permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.
Exemplos
R. Listar as informações de todas as contas
O exemplo a seguir mostra a lista de informações de conta para todas as contas na instância.
EXEC msdb.dbo.sysmail_help_account_sp;
Conjunto de resultados de exemplo, editado para comprimento de linha:
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. Listar as informações de uma conta específica
O exemplo a seguir mostra a lista de informações de conta para a conta denominada AdventureWorks Administrator
.
EXEC msdb.dbo.sysmail_help_account_sp
@account_name = 'AdventureWorks Administrator';
Conjunto de resultados de exemplo, editado para comprimento de linha:
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