PAPEL DE DESISTÊNCIA (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Base de dados SQL no Microsoft Fabric

Remove uma função do banco de dados.

Transact-SQL convenções de sintaxe

Syntax

Sintaxe para SQL Server, Banco de Dados SQL do Azure, Instância Gerenciada SQL do Azure e Banco de Dados SQL de Malha

DROP ROLE [ IF EXISTS ] role_name

Sintaxe para o Azure Synapse Analytics e o Parallel Data Warehouse

DROP ROLE role_name

Arguments

SE EXISTE
Aplica-se a: SQL Server (SQL Server 2016 (13.x) até a versão atual).

Condicionalmente abandona a função apenas se ela já existir.

role_name
Especifica a função a ser descartada do banco de dados.

Remarks

As funções que possuem protegíveis não podem ser descartadas do banco de dados. Para descartar uma função de banco de dados que possui protegíveis, você deve primeiro transferir a propriedade desses protegíveis ou soltá-los do banco de dados. As funções que têm membros não podem ser descartadas do banco de dados. Para descartar uma função que tenha membros, você deve primeiro remover membros da função.

Para remover membros de uma função de banco de dados, use ALTER ROLE (Transact-SQL).

Não é possível usar DROP ROLE para descartar uma função de banco de dados fixa.

As informações sobre a associação à função podem ser visualizadas na exibição de catálogo sys.database_role_members.

Note

Os esquemas não são equivalentes aos usuários do banco de dados. Use as exibições do catálogo do sistema para identificar quaisquer diferenças entre os usuários e esquemas do banco de dados.

Para remover uma função de servidor, use DROP SERVER ROLE (Transact-SQL).

Permissions

Requer a permissão ALTER ANY ROLE no banco de dados, ou a permissão CONTROL na função, ou a associação ao db_securityadmin.

Examples

O exemplo a seguir descarta a função purchasing de banco de dados do AdventureWorks2025 banco de dados.

DROP ROLE purchasing;  
GO  

Ver também

CRIAR FUNÇÃO (Transact-SQL)
ALTER PAPEL (Transact-SQL)
Principais (Motor de Base de Dados)
EVENTDATA (Transact-SQL)
sp_addrolemember (Transact-SQL)
sys.database_role_members (Transact-SQL)
sys.database_principals (Transact-SQL)
Funções de segurança (Transact-SQL)