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自动删除依赖于该函数的对象(例如操作符或触发器),并进而删除所有依赖于这些对象的对象(参见 Section 5.15)。
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 选项
指定参数模式和参数名称的能力