DROP SYNONYM (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed Instance

Entfernt ein Synonym aus einem angegebenen Schema.

Transact-SQL-Syntaxkonventionen

Syntax

DROP SYNONYM [ IF EXISTS ] [ schema. ] synonym_name

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

IF EXISTS
Gilt für: SQL Server (SQL Server 2016 (13.x) bis zur aktuellen Version).

Löscht das Synonym nur, wenn dieses bereits vorhanden ist.

schema
Gibt das Schema an, in dem das Synonym vorhanden ist. Wird kein Schema angegeben, verwendet SQL Server das Standardschema des aktuellen Benutzers.

synonym_name
Der Name des Synonyms, das gelöscht werden soll.

Bemerkungen

Verweise auf Synonyme sind nicht an ein Schema gebunden. Deshalb können Sie ein Synonym jederzeit löschen. Verweise auf gelöschte Synonyme werden erst zur Laufzeit gefunden.

In dynamischem SQL können Synonyme erstellt und gelöscht werden. Außerdem kann auf sie verwiesen werden.

Berechtigungen

Zum Löschen eines Synonyms muss ein Benutzer mindestens eine der folgenden Bedingungen erfüllen. Folgende Voraussetzungen müssen erfüllt sein:

  • Der Benutzer muss der aktuelle Besitzer eines Synonyms sein.

  • Der Benutzer muss ein Berechtigter für CONTROL für ein Synonym sein.

  • Der Benutzer muss ein Berechtigter sein, der über die ALTER SCHEMA-Berechtigung für das enthaltene Schema verfügt.

Beispiele

Im folgenden Beispiel wird zuerst das Synonym MyProduct erstellt und dann gelöscht.

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

Siehe auch

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