sysmail_help_profile_sp (Transact-SQL)
Aplica-se: SQL Server
Lista informações sobre um ou mais perfis de email.
Convenções de sintaxe de Transact-SQL
Sintaxe
sysmail_help_profile_sp [ [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' ]
[ ; ]
Argumentos
@profile_id [ = ] profile_id
A ID do perfil para a qual retornar informações. @profile_id é int, com um padrão de NULL
.
@profile_name [ = ] 'profile_name'
O nome do perfil do qual retornar informações. @profile_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 com as seguintes colunas.
Nome da coluna | Tipo de dados | Descrição |
---|---|---|
profile_id |
int | A ID do perfil. |
name |
sysname | O nome de perfil para o perfil. |
description |
nvarchar(256) | A descrição para o perfil. |
Comentários
Quando um nome de perfil ou ID de perfil é especificado, sysmail_help_profile_sp
retorna informações sobre esse perfil. Caso contrário, sysmail_help_profile_sp
retornará informações sobre cada perfil na instância do SQL Server.
O procedimento sysmail_help_profile_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
Você pode conceder EXECUTE
permissões nesse procedimento, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.
Exemplos
R. Listar todos os perfis
O exemplo a seguir mostra a lista de todos os perfis na instância.
EXEC msdb.dbo.sysmail_help_profile_sp;
Conjunto de resultados de exemplo, reformatado para comprimento de linha:
profile_id name description
----------- ----------------------------- ------------------------------
56 AdventureWorks Administrator Administrative mail profile.
57 AdventureWorks Operator Operator mail profile.
B. Listar um perfil específico
O exemplo a seguir mostra as informações de listagem para o perfil AdventureWorks Administrator
.
EXEC msdb.dbo.sysmail_help_profile_sp
@profile_name = 'AdventureWorks Administrator' ;
Conjunto de resultados de exemplo, reformatado para comprimento de linha:
profile_id name description
----------- ----------------------------- ------------------------------
56 AdventureWorks Administrator Administrative mail profile.