DROP SYNONYM (Transact-SQL)
Aplica-se a: SQL Server
Banco de Dados
SQL do Azure Instâ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