登录
DROP FUNCTION
DROP FUNCTION — 删除函数
语法
DROP FUNCTION [ IF EXISTS ] name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] [, ...]
[ CASCADE | RESTRICT ]
说明
DROP FUNCTION
删除现有函数的定义。要执行此命令,用户必须是函数的所有者。必须指定函数的参数类型,因为可以存在具有相同名称和不同参数列表的多个不同函数。
参数
IF EXISTS
如果函数不存在,则不抛出错误。在这种情况下,会发出通知。
name
现有函数的名称(可选模式限定)。如果未指定参数列表,则名称在其模式中必须是唯一的。
argmode
参数模式:
IN
、OUT
、INOUT
或VARIADIC
。如果省略,则默认为IN
。请注意,DROP FUNCTION
实际上不会关注OUT
参数,因为只需输入参数即可确定函数标识。因此,列出IN
、INOUT
和VARIADIC
参数就足够了。argname
参数名称。请注意,
DROP FUNCTION
实际上不会关注参数名称,因为只需参数数据类型即可确定函数标识。argtype
函数参数的数据类型(可选模式限定),如果有的话。
CASCADE
自动删除依赖于该函数的对象(例如运算符或触发器),进而删除所有依赖于这些对象的对象(请参阅第 5.14 节)。
RESTRICT
如果任何对象依赖于该函数,则拒绝删除该函数。这是默认设置。
示例
此命令删除平方根函数
DROP FUNCTION sqrt(integer);
在一个命令中删除多个函数
DROP FUNCTION sqrt(integer), sqrt(bigint);
如果函数名称在其模式中是唯一的,则可以引用它而不使用参数列表
DROP FUNCTION update_employee_salaries;
请注意,这与
DROP FUNCTION update_employee_salaries();
不同,后者引用的是一个没有参数的函数,而第一个变量可以引用一个具有任意数量参数(包括零)的函数,只要名称是唯一的。
兼容性
此命令符合 SQL 标准,并带有以下PostgreSQL扩展
该标准只允许每个命令删除一个函数。
IF EXISTS
选项指定参数模式和名称的能力