SQL COMMAND · 函数与过程

DROP FUNCTION

移除一个函数

DROP函数与过程引入 10（基线）现存至 20 devel0 次语法变更

版本轨迹

相对 PostgreSQL 17 无变化。

沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。

DROP FUNCTION [ IF EXISTS ] name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] [, ...]
    [ CASCADE | RESTRICT ]

PostgreSQL 18 手册 · 查看完整参考页

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扩展：

相邻大版本之间的差异，新的在前。版本号链接到对应快照。

命令	动词	对象	最近变更
FUNCTIONS & PROCEDURES函数与过程18 条↑
`CALL`	CALL	—	—
调用一个过程			现存
`DO`	DO	—	—
执行匿名代码块			现存
`CREATE AGGREGATE`	CREATE	AGGREGATE	203 次
定义一个新的聚合函数			现存
`ALTER AGGREGATE`	ALTER	AGGREGATE	141 次
更改一个聚合函数的定义			现存
`DROP AGGREGATE`	DROP	AGGREGATE	—
移除一个聚合函数			现存
`CREATE FUNCTION`	CREATE	FUNCTION	143 次
定义一个新函数			现存
`ALTER FUNCTION`	ALTER	FUNCTION	143 次
更改函数的定义			现存
`DROP FUNCTION`	DROP	FUNCTION	—
移除一个函数			现存
`CREATE LANGUAGE`	CREATE	LANGUAGE	131 次
定义一种新的过程语言			现存
`ALTER LANGUAGE`	ALTER	LANGUAGE	141 次
更改一种过程语言的定义			现存
`DROP LANGUAGE`	DROP	LANGUAGE	—
移除一种过程语言			现存
`CREATE PROCEDURE`	CREATE	PROCEDURE	141 次
定义一个新过程			现存
`ALTER PROCEDURE`	ALTER	PROCEDURE	142 次
更改过程的定义			现存
`DROP PROCEDURE`	DROP	PROCEDURE	—
移除一个过程			现存
`ALTER ROUTINE`	ALTER	ROUTINE	142 次
更改一个例程的定义			现存
`DROP ROUTINE`	DROP	ROUTINE	—
移除一个例程			现存
`CREATE TRANSFORM`	CREATE	TRANSFORM	—
定义一个新的转换			现存
`DROP TRANSFORM`	DROP	TRANSFORM	—
移除一个转换			现存