DROP SYNONYM (Transact-SQL)
S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance
Supprime un synonyme d'un schéma spécifié.
Conventions de la syntaxe Transact-SQL
Syntaxe
DROP SYNONYM [ IF EXISTS ] [ schema. ] synonym_name
Arguments
IF EXISTS
S’applique à: SQL Server (de SQL Server 2016 (13.x) à la version actuelle).
Supprime, de manière conditionnelle, le synonyme uniquement s’il existe déjà.
schema
Spécifie le schéma dans lequel le synonyme existe. Si le schéma n'est pas spécifié, SQL Server utilise le schéma par défaut de l'utilisateur actuel.
synonym_name
Nom du synonyme à supprimer.
Notes
Les références aux synonymes ne sont pas liées aux schémas ; vous pouvez supprimer un synonyme à n'importe quel moment. Les références aux synonymes supprimés ne se rencontrent que lors de l'exécution.
Vous pouvez créer, supprimer et référencer des synonymes dans des instructions SQL dynamiques.
Autorisations
Pour supprimer un synonyme, un utilisateur doit satisfaire au moins l'une des conditions suivantes. L'utilisateur doit être :
Le propriétaire actuel d'un synonyme.
Un bénéficiaire possédant une autorisation CONTROL sur un synonyme.
Un bénéficiaire possédant une autorisation ALTER SCHEMA sur le schéma conteneur.
Exemples
L'exemple suivant crée d'abord un synonyme, MyProduct
, puis le supprime.
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