DROP SYNONYM (Transact-SQL)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Quita un sinónimo de un esquema especificado.

Convenciones de sintaxis de Transact-SQL

Sintaxis

DROP SYNONYM [ IF EXISTS ] [ schema. ] synonym_name  

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

IF EXISTS
Se aplica a: SQL Server (desde SQL Server 2016 (13.x) hasta la versión actual).

Quita condicionalmente el sinónimo solo si ya existe.

schema
Especifica el esquema en el que existe el sinónimo. Si no se especifica, SQL Server utiliza el esquema predeterminado del usuario actual.

synonym_name
Es el nombre del sinónimo que se va a quitar.

Observaciones

Las referencias a sinónimos no están enlazadas al esquema, por lo que un sinónimo se puede quitar cuando se desee. Las referencias a sinónimos quitados solo se encontrarán en tiempo de ejecución.

Es posible crear, quitar y hacer referencia a sinónimos en SQL dinámico.

Permisos

Para quitar un sinónimo, un usuario debe cumplir al menos una de las condiciones siguientes. El usuario debe ser:

  • El propietario actual del sinónimo.

  • Receptor del permiso CONTROL en el sinónimo.

  • Receptor del permiso ALTER SCHEMA en el esquema contenedor.

Ejemplos

En el ejemplo siguiente, primero se crea el sinónimo MyProduct y después se quita.

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  

Consulte también

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