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.16 节)。
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选项是扩展。允许指定参数模式和参数名是扩展。