sysmail_help_principalprofile_sp (Transact-SQL)
Lista informações sobre associações entre perfis de Database Mail e entidades do banco de dados.
.gif "Ícone de vínculo de tópico")
Sintaxe
sysmail_help_principalprofile_sp [ { [ @principal_id = ] principal_id | [ @principal_name = ] 'principal_name' } ]
[ [ , ] { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ]
Argumentos
[ @principal_id= ] principal_id
É o ID do usuário do banco de dados ou da função no banco de dados msdb da associação a ser listada. principal_id é int, com um padrão NULL. Pode ser especificada a principal_id ou o principal_name.[ @principal_name= ] 'principal_name'
É o nome do usuário do banco de dados ou da função no banco de dados msdb da associação a ser listada. principal_name é sysname, com um padrão NULL. Pode ser especificada a principal_id ou o principal_name.[ @profile_id= ] profile_id
É o ID do perfil da associação a ser listada. profile_id é int, com um padrão NULL. Pode ser especificada a profile_id ou o profile_name.[ @profile_name= ] 'profile_name'
É o nome do perfil da associação a ser listada. profile_name é sysname, com um padrão NULL. Pode ser especificada a profile_id ou o profile_name.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Conjuntos de resultados
Retorna um conjunto de resultados que contém as colunas listadas na tabela a seguir.
Nome da coluna |
Tipo de dados |
Descrição |
principal_id |
int |
O ID do usuário do banco de dados. |
principal_name |
sysname |
O nome do usuário do banco de dados. |
profile_id |
int |
O número do ID do perfil de Database Mail. |
profile_name |
sysname |
O nome do perfil de Database Mail. |
is_default |
bit |
O sinalizador que indica se este é o perfil padrão do usuário. |
Comentários
Se sysmail_help_principalprofile_sp for invocado sem parâmetros, o conjunto de resultados retornado listará todas as associações na instância de SQL Server. Caso contrário, o conjunto de resultados conterá informações sobre as associações correspondentes aos parâmetros fornecidos. Por exemplo, o procedimento lista todas as associações de um perfil quando o nome de perfil for fornecido.
sysmail_help_principalprofile_sp está no banco de dados msdb e pertence ao esquema dbo. O procedimento deverá ser executado com um nome de três partes se o banco de dados atual não for msdb.
Permissões
Requer associação na função de servidor fixa sysadmin.
Exemplos
A. Listando informações de uma associação específica
O exemplo a seguir mostra a lista de informações de todas as associações entre o perfil AdventureWorks Administrator e a entidade ApplicationLogin no banco de dados msdb.
EXECUTE msdb.dbo.sysmail_help_principalprofile_sp
@principal_name = 'danw',
@profile_name = 'AdventureWorks Administrator' ;
Conjunto de resultados de exemplo, reformatado para comprimento de linha.
principal_id principal_name profile_id profile_name is_default
------------ ------------------ ----------- ------------------------------ ----------
5 danw 9 AdventureWorks Administrator 1
B. Listando informações de todas as associações
O exemplo a seguir mostra a lista de informações de todas as associações na instância.
EXECUTE msdb.dbo.sysmail_help_principalprofile_sp ;
Conjunto de resultados de exemplo, reformatado para comprimento de linha.
principal_id principal_name profile_id profile_name is_default
------------ ------------------ ----------- ------------------------------ ----------
6 terrid 3 Product Update Profile 1
5 danw 9 AdventureWorks Administrator 1
Consulte também