DROP SYNONYM (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Remove um sinônimo de um esquema especificado.

Convenções de sintaxe de Transact-SQL

Sintaxe

DROP SYNONYM [ IF EXISTS ] [ schema. ] synonym_name

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

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

Remove condicionalmente o sinônimo somente se ele já existe.

schema
Especifica o esquema no qual o sinônimo existe. Se o esquema não for especificado, SQL Server usará o esquema padrão do usuário atual.

synonym_name
É o nome do sinônimo a ser descartado.

Comentários

Referências a sinônimos não são associadas a esquemas. Portanto, você pode descartar um sinônimo a qualquer momento. As referências a sinônimos descartados só serão localizadas no momento da execução.

É possível criar, descartar e referenciar sinônimos em SQL dinâmico.

Permissões

Para descartar um sinônimo, um usuário deve satisfazer pelo menos uma das condições a seguir. O usuário deve ser:

  • O proprietário atual de um sinônimo.

  • Um usuário autorizado que mantenha CONTROL em um sinônimo.

  • Um usuário autorizado que mantenha a permissão ALTER SCHEMA no esquema contentor.

Exemplos

O exemplo a seguir primeiramente cria um sinônimo MyProduct e, em seguida, descarta-o.

USE tempdb;  
GO  
-- Create a synonym for the Product table in AdventureWorks2022.  
CREATE SYNONYM MyProduct  
FOR AdventureWorks2022.Production.Product;  
GO  
-- Drop synonym MyProduct.  
USE tempdb;  
GO  
DROP SYNONYM MyProduct;  
GO

Consulte Também

CREATE SYNONYM (Transact-SQL)
EVENTDATA (Transact-SQL)