sysmail_delete_principalprofile_sp (Transact-SQL)

  • Artigo

Aplica-se a:SQL Server

Remove a permissão de um usuário do banco de dados ou função para usar um perfil público ou privado do Database Mail.

Convenções de sintaxe de Transact-SQL

Sintaxe

sysmail_delete_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 excluir. @principal_id é int, com um padrão de NULL. Para transformar um perfil público em um perfil privado, forneça o ID 0 principal ou o nome publicprincipal. Devem ser especificados @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 excluir. @principal_name é sysname, com um padrão de NULL. Para transformar um perfil público em um perfil privado, forneça o ID 0 principal ou o nome publicprincipal. Devem ser especificados @principal_id ou @principal_name .

@profile_id [ = ] profile_id

A ID do perfil da associação a ser excluída. @profile_id é int, com um padrão de NULL. Devem ser especificados @profile_id ou @profile_name .

@profile_name [ = ] 'profile_name'

O nome do perfil da associação a ser excluída. @profile_name é sysname, com um padrão de NULL. Devem ser especificados @profile_id ou @profile_name .

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

Para transformar um perfil público em um perfil privado, forneça "público" para o nome principal ou 0 para o ID principal.

Tenha cuidado ao remover permissões do perfil privado padrão para um usuário ou do perfil público padrão. Quando nenhum perfil padrão está disponível, sp_send_dbmail requer o nome de um perfil como um argumento. Portanto, a remoção de um perfil padrão faz com que as sp_send_dbmail chamadas falhem. Para obter mais informações, consulte sp_send_dbmail (Transact-SQL).

O procedimento sysmail_delete_principalprofile_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 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

O exemplo a seguir mostra a exclusão da associação entre o perfil AdventureWorks Administrator e o logon ApplicationUser no msdb banco de dados.

EXEC msdb.dbo.sysmail_delete_principalprofile_sp
    @principal_name = 'ApplicationUser',
    @profile_name = 'AdventureWorks Administrator';

Conteúdo relacionado