DROP SYNONYM (Transact-SQL)

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

Удаляет синонимы из указанной схемы.

Соглашения о синтаксисе Transact-SQL

Синтаксис

DROP SYNONYM [ IF EXISTS ] [ schema. ] synonym_name  

Аргументы

IF EXISTS
Применимо к: SQL Server (SQL Server 2016 (13.x) до текущей версии.

Условное удаление синонима только в том случае, если он уже существует.

schema
Указывает схему, в которой существует этот синоним. Если схема не указана, SQL Server использует схему по умолчанию текущего пользователя.

synonym_name
Имя синонима, который нужно удалить.

Замечания

Ссылки на синонимы не привязаны к схемам, поэтому удаление синонима возможно в любое время. Ссылки на удаленные синонимы можно обнаружить только во время выполнения.

Синонимы можно создавать, удалять и ссылаться на них в динамическом SQL.

Разрешения

Чтобы удалить синоним, пользователь должен выполнить, по крайней мере, одно из следующих условий. Пользователь должен являться:

  • текущим владельцем синонима;

  • участником, которому предоставлено разрешение CONTROL на синоним;

  • участником, которому предоставлено разрешение ALTER SCHEMA на содержащую синоним схему.

Примеры

В следующем примере сначала создается синоним MyProduct, а затем этот синоним удаляется.

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  

См. также

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