DROP SYNONYM (Transact-SQL)

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

指定されたスキーマからシノニムを削除します。

Transact-SQL 構文表記規則

構文

DROP SYNONYM [ IF EXISTS ] [ schema. ] synonym_name

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

IF EXISTS
適用対象: SQL Server (SQL Server 2016 (13.x) から現在のバージョンまで)。

条件付きでは既に存在する場合にのみ、シノニムを削除します。

schema
シノニムが存在するスキーマを指定します。 スキーマを指定しない場合、SQL Server によって現在のユーザーの既定のスキーマが使用されます。

synonym_name
削除するシノニムの名前です。

注釈

シノニムへの参照はスキーマにバインドされていません。したがってシノニムはいつでも削除できます。 削除したシノニムへの参照は、実行時にのみ検出されます。

シノニムは、動的な SQL で作成、削除、参照することができます。

アクセス許可

シノニムを削除するには、ユーザーは次の条件を少なくとも 1 つ 満たしている必要があります。

  • シノニムの現在の所有者である。

  • シノニムに対する 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)