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.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
选项
指定参数模式和名称的能力
如果您在文档中发现任何不正确、与您对特定功能的实际使用经验不符或需要进一步澄清的内容,请使用 此表单 报告文档问题。