DROP SYNONYM (Transact-SQL)

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure 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

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

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

Voir aussi

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