sysmail_help_profileaccount_sp (Transact-SQL)
Aplica-se: SQL Server
Lista as contas associadas a um ou mais perfis do Database Mail.
Convenções de sintaxe de Transact-SQL
Sintaxe
sysmail_help_profileaccount_sp
{ [ @profile_id = ] profile_id
| [ @profile_name = ] 'profile_name' }
[ , { [ @account_id = ] account_id
| [ @account_name = ] 'account_name' } ]
[ ; ]
Argumentos
@profile_id [ = ] profile_id
A ID do perfil a ser listado. @profile_id é int, com um padrão de NULL
. Deve ser especificado @profile_id ou @profile_name .
@profile_name [ = ] 'profile_name'
O nome do perfil a ser listado. @profile_name é sysname, com um padrão de NULL
. Deve ser especificado @profile_id ou @profile_name .
@account_id [ = ] account_id
O ID da conta a ser listado. @account_id é int, com um padrão de NULL
. Quando @account_id e @account_name são ambos NULL
, lista todas as contas no perfil.
@account_name [ = ] 'account_name'
O nome da conta a ser listada. @account_name é sysname, com um padrão de NULL
. Quando @account_id e @account_name são ambos NULL
, lista todas as contas no perfil.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Conjunto de resultados
Retorna um conjunto de resultados com as seguintes colunas.
Nome da coluna | Tipo de dados | Descrição |
---|---|---|
profile_id |
int | O ID do perfil. |
profile_name |
sysname | O nome do perfil. |
account_id |
int | O ID da conta. |
account_name |
sysname | O nome da conta. |
sequence_number |
int | O número de sequência da conta dentro do perfil. |
Comentários
Quando nenhum @profile_id ou @profile_name é especificado, esse procedimento armazenado retorna informações para cada perfil na instância.
O procedimento sysmail_help_profileaccount_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 contas de um perfil específico por nome
O exemplo a seguir mostra a lista de informações do perfil AdventureWorks Administrator
, especificando o nome do perfil.
EXEC msdb.dbo.sysmail_help_profileaccount_sp
@profile_name = 'AdventureWorks Administrator';
Conjunto de resultados de exemplo, editado para comprimento de linha:
profile_id profile_name account_id account_name sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131 AdventureWorks Administrator 197 Admin-MainServer 1
131 AdventureWorks Administrator 198 Admin-BackupServer 2
B. Listar as contas de um perfil específico por ID de perfil
O exemplo a seguir mostra a lista de informações do perfil AdventureWorks Administrator
, especificando o ID do perfil.
EXEC msdb.dbo.sysmail_help_profileaccount_sp
@profile_id = 131 ;
Conjunto de resultados de exemplo, editado para comprimento de linha:
profile_id profile_name account_id account_name sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131 AdventureWorks Administrator 197 Admin-MainServer 1
131 AdventureWorks Administrator 198 Admin-BackupServer 2
C. Listar as contas de todos os perfis
O exemplo a seguir mostra a lista de contas de todos os perfis na instância.
EXEC msdb.dbo.sysmail_help_profileaccount_sp;
Conjunto de resultados de exemplo, editado para comprimento de linha:
profile_id profile_name account_id account_name sequence_number
----------- ---------------------------- ----------- -------------------- ---------------
131 AdventureWorks Administrator 197 Admin-MainServer 1
131 AdventureWorks Administrator 198 Admin-BackupServer 2
106 AdventureWorks Operator 210 Operator-MainServer 1