DROP FUNCTION (Transact-SQL)

Применимо к:SQL ServerБаза данных Azure SQLУправляемый экземпляр Azure SQLAzure Synapse AnalyticsСистема платформы аналитики (PDW)Конечная точка SQL аналитики в Microsoft FabricХранилище в Microsoft FabricБаза данных SQL в Microsoft Fabric

Удаляет из текущей базы данных одну или несколько пользовательских функций. Пользовательские функции создаются с CREATE FUNCTION помощью и изменяются с ALTER FUNCTIONпомощью .

Функция DROP поддерживает скомпилированные в собственном коде скалярные определяемые пользователем функции. Дополнительные сведения см. в разделе Скалярные определяемые пользователем функции для выполняющейся в памяти OLTP.

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

Синтаксис

 -- 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
[;] 

Аргументы

ЕСЛИ СУЩЕСТВУЕТ
Условно удаляет функцию только в том случае, если она уже существует. Доступно в SQL Server начиная с версии 2016 и в Базе данных SQL.

schema_name
Имя схемы, к которой принадлежит определяемая пользователем функция.

function_name
Имя удаляемой пользовательской функции или функций. Указание имени схемы является необязательным. Невозможно указать имя сервера и имя базы данных.

Замечания

DROP FUNCTION не сработает, если в базе данных есть Transact-SQL функции или представления, которые ссылаются на эту функцию и были созданы с помощью SCHEMABINDING, или если есть вычисленные столбцы, ограничения CHECK или DEFAULT ограничения, ссылающиеся на эту функцию.

DROP FUNCTION не сработает, если есть вычисленные столбцы, ссылающиеся на эту функцию и индексированные.

Разрешения

Для выполнения DROP FUNCTION, как минимум, пользователь должен иметь разрешение ALTER на схеме, к которой принадлежит функция, или разрешение CONTROL на функцию.

Примеры

А. Удаление функции

Следующий пример убирает fn_SalesByStore пользовательскую функцию из Sales схемы в образцовой базе данных AdventureWorks2025. Чтобы создать эту функцию, см. Пример B в CREATE FUNCTION (Transact-SQL).

DROP FUNCTION Sales.fn_SalesByStore;  

См. также

ALTER FUNCTION (Transact-SQL)
CREATE FUNCTION (Transact-SQL)
OBJECT_ID (Transact-SQL)
EVENTDATA (Transact-SQL)
sys.sql_модули (Transact-SQL)
sys.parameters (Transact-SQL)