Compartilhar via


sysmail_help_principalprofile_sp (Transact-SQL)

Lista informações sobre associações entre perfis de Database Mail e entidades do banco de dados.

Ícone de vínculo de tópicoConvenções de sintaxe 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
    É 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