DESCARTAR FUNÇÃO (Transact-SQL)

2025-07-29

Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure Azure Synapse Analytics PDW (Analytics Platform System)Banco de dados SQL no Microsoft Fabric Preview

Remove uma função do banco de dados.

Convenções de sintaxe de Transact-SQL

Syntax

Sintaxe para SQL Server, Banco de Dados SQL do Azure, Instância Gerenciada de SQL do Azure e banco de dados SQL de malha

DROP ROLE [ IF EXISTS ] role_name

Sintaxe do Azure Synapse Analytics e do Parallel Data Warehouse

DROP ROLE role_name

Arguments

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

Remove condicionalmente a função somente se ela já existe.

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

Remarks

As funções que possuem itens protegíveis não podem ser descartadas do banco de dados. Para descartar uma função de banco de dados que possui protegíveis, é necessário primeiro transferir a propriedade dos protegíveis ou descartá-los do banco de dados. As funções que possuem membros não podem ser descartadas do banco de dados. Para descartar uma função que possui membros, você deve primeiro remover os membros da função.

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

Você não pode usar DROP ROLE para descartar uma função de banco de dados fixa.

Informações sobre associação de função podem ser exibidas na exibição do catálogo sys.database_role_members.

Note

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

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

Permissions

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

Examples

O exemplo a seguir remove a função de banco de dados purchasing do banco de dados AdventureWorks2022.

DROP ROLE purchasing;  
GO

Comentários

Esta página foi útil?