| title | DROP SYNONYM (Transact-SQL) | Microsoft Docs | |||||
|---|---|---|---|---|---|---|
| ms.custom |
|
|||||
| ms.date | 07/26/2017 | |||||
| ms.prod | sql-non-specified | |||||
| ms.reviewer | ||||||
| ms.suite | ||||||
| ms.technology |
|
|||||
| ms.tgt_pltfrm | ||||||
| ms.topic | language-reference | |||||
| f1_keywords |
|
|||||
| dev_langs |
|
|||||
| helpviewer_keywords |
|
|||||
| ms.assetid | 23578932-e4de-4c39-a5a0-ce45139c4269 | |||||
| caps.latest.revision | 24 | |||||
| author | BYHAM | |||||
| ms.author | rickbyh | |||||
| manager | jhubbard |
[!INCLUDEtsql-appliesto-ss2008-asdb-xxxx-xxx_md]
Removes a synonym from a specified schema.
Transact-SQL Syntax Conventions
DROP SYNONYM [ IF EXISTS ] [ schema. ] synonym_name
IF EXISTS
Applies to: [!INCLUDEssNoVersion] ([!INCLUDEssSQL15] 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