| title | DROP SYNONYM (Transact-SQL) | |||||
|---|---|---|---|---|---|---|
| description | DROP SYNONYM (Transact-SQL) | |||||
| author | WilliamDAssafMSFT | |||||
| ms.author | wiassaf | |||||
| ms.date | 07/26/2017 | |||||
| ms.prod | sql | |||||
| ms.prod_service | database-engine, sql-database | |||||
| ms.technology | t-sql | |||||
| ms.topic | reference | |||||
| f1_keywords |
|
|||||
| helpviewer_keywords |
|
|||||
| dev_langs |
|
[!INCLUDE SQL Server Azure SQL Database Azure SQL Managed Instance]
Removes a synonym from a specified schema.
Transact-SQL Syntax Conventions
DROP SYNONYM [ IF EXISTS ] [ schema. ] synonym_name
[!INCLUDEsql-server-tsql-previous-offline-documentation]
IF EXISTS
Applies to: [!INCLUDEssNoVersion] ( [!INCLUDEsssql16-md] through current version).
Conditionally drops the synonym only if it already exists.
schema
Specifies the schema in which the synonym exists. If schema is not specified, [!INCLUDEssNoVersion] uses the default schema of the current user.
synonym_name
Is the name of the synonym to be dropped.
References to synonyms are not schema-bound; therefore, you can drop a synonym at any time. References to dropped synonyms will be found only at run time.
Synonyms can be created, dropped and referenced in dynamic SQL.
To drop a synonym, a user must satisfy at least one of the following conditions. The user must be:
-
The current owner of a synonym.
-
A grantee holding CONTROL on a synonym.
-
A grantee holding ALTER SCHEMA permission on the containing schema.
The following example first creates a synonym, MyProduct, and then drops the synonym.
USE tempdb;
GO
-- Create a synonym for the Product table in AdventureWorks2012.
CREATE SYNONYM MyProduct
FOR AdventureWorks2012.Production.Product;
GO
-- Drop synonym MyProduct.
USE tempdb;
GO
DROP SYNONYM MyProduct;
GO