sysmail_help_principalprofile_sp (Transact-SQL)
Aplica-se a: 
SQL Server
Lista informações sobre associações entre perfis de Database Mail e entidades do banco de dados.
Convenções de sintaxe de Transact-SQL
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
A ID do usuário ou função do banco de dados no msdb banco de dados para a associação listar. @principal_id é int, com um padrão de NULL. Deve ser especificado @principal_id ou @principal_name .
@principal_name [ = ] 'principal_name'
O nome do usuário ou função do banco de dados no msdb banco de dados para a associação listar. @principal_name é sysname, com um padrão de NULL. Deve ser especificado @principal_id ou @principal_name .
@profile_id [ = ] profile_id
A ID do perfil para a associação listar. @profile_id é int, com um padrão de NULL. Podem ser especificados @profile_id ou @profile_name .
@profile_name [ = ] 'profile_name'
O nome do perfil da associação a ser listada. @profile_name é sysname, com um padrão de NULL. Podem ser especificados @profile_id ou @profile_name .
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 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 do 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 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 msdbfor .
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 informações para 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.
EXEC 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. Listar informações para todas as associações
O exemplo a seguir mostra a lista de informações de todas as associações na instância.
EXEC 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