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