Compartilhar via


sp_dropapprole (Transact-SQL)

Remove uma função de aplicativo do banco de dados atual.

Observação importanteImportante

Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use DROP APPLICATION ROLE.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_dropapprole [@rolename = ] 'role'

Argumentos

  • [ @rolename = ] 'role'
    É a função de aplicativo a ser removida. role é sysname, sem nenhum padrão. role deve existir no banco de dados atual.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_dropapprole pode ser usado somente para remover funções de aplicativo. Se uma função possuir algum item protegível, a função não poderá ser descartada. Antes de descartar uma função de aplicativo que possui itens protegíveis, é necessário transferir a propriedade dos itens protegíveis primeiro ou descartá-los.

sp_dropapprole não pode ser executado em uma transação definida pelo usuário.

Permissões

Requer a permissão ALTER ANY APPLICATION ROLE no banco de dados.

Exemplos

O exemplo a seguir remove a função de aplicativo SalesApp do banco de dados atual.

EXEC sp_dropapprole 'SalesApp'