Compartilhar via


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