DROP FUNCTION (Transact-SQL)

Artículo
10/16/2024

Se aplica a: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) Punto de conexión de análisis SQL en Microsoft Fabric Almacenamiento en Microsoft Fabric

Quita una o más funciones definidas por el usuario de la base de datos actual. Las funciones definidas por el usuario se crean mediante CREATE FUNCTION y se modifican con ALTER FUNCTION.

La función DROP admite funciones escalares definidas por el usuario y compiladas de forma nativa. Para obtener más información, vea Funciones escalares definidas por el usuario para OLTP en memoria.

Convenciones de sintaxis de Transact-SQL

Sintaxis

 -- SQL Server, Azure SQL Database 

DROP FUNCTION [ IF EXISTS ] { [ schema_name. ] function_name } [ ,...n ]   
[;]

 -- Azure Synapse Analytics, Parallel Data Warehouse, Microsoft Fabric

DROP FUNCTION [IF EXISTS] [ schema_name. ] function_name
[;]

Argumentos

IF EXISTS
Quita la función condicionalmente solo si ya existe. Disponible a partir de SQL Server 2016 y en SQL Database.

schema_name
Nombre del esquema al que pertenece la función definida por el usuario.

function_name
Es el nombre de la función definida por el usuario que se va a quitar. Especificar el nombre del esquema es opcional. No se pueden especificar el nombre del servidor ni el nombre de la base de datos.

Observaciones

DROP FUNCTION no funcionará correctamente si existen vistas o funciones de Transact-SQL en la base de datos que hacen referencia a esta función y que fueron creadas con SCHEMABINDING; tampoco funcionará si existen columnas calculadas o restricciones CHECK o DEFAULT que hacen referencia a la función.

DROP FUNCTION no funcionará correctamente si existen columnas calculadas que hacen referencia a esta función y que han sido indizadas.

Permisos

Para ejecutar DROP FUNCTION, el usuario debe, como mínimo, contar con permiso de tipo ALTER sobre el esquema al que pertenece la función, o con un permiso de tipo CONTROL sobre la función.

Ejemplos

A. Quitar una función

En este ejemplo se quita la función definida por el usuario fn_SalesByStore del esquema Sales en la base de datos de ejemplo AdventureWorks2022. Para crear esta función, vea el ejemplo B en CREATE FUNCTION (Transact-SQL).

DROP FUNCTION Sales.fn_SalesByStore;

Consulte también

ALTER FUNCTION (Transact-SQL)
CREATE FUNCTION (Transact-SQL)
OBJECT_ID (Transact-SQL)
EVENTDATA (Transact-SQL)
sys.sql_modules (Transact-SQL)
sys.parameters (Transact-SQL)

Compartir vía