SQL COMMAND · 函数与过程

DROP FUNCTION

移除一个函数

remove a function

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

版本轨迹

相对 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: 自动删除依赖于该函数的对象（例如操作符或触发器），以及进一步依赖于这些对象的所有对象（参见第 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 扩展：

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

PostgreSQL 19← 18正文更新

正文更新
PostgreSQL 17← 16正文更新

正文更新
PostgreSQL 12← 11正文更新

正文更新
PostgreSQL 11← 10正文更新

正文更新
PostgreSQL 10← 9.6语法变化

+ DROP FUNCTION [ IF EXISTS ] name [ ( [ [ argmode ] [ argname ] argtype [, ...] ] ) ] [, ...]正文更新
PostgreSQL 9.6← 9.5正文更新

正文更新
PostgreSQL 8.4← 8.3正文更新

正文更新
PostgreSQL 8.3← 8.2正文更新

正文更新
PostgreSQL 8.2← 8.1语法变化

+ DROP FUNCTION [ IF EXISTS ] name ( [ [ argmode ] [ argname ] argtype [, ...] ] )正文更新
PostgreSQL 8.1← 8.0语法变化

+ DROP FUNCTION name ( [ [ argmode ] [ argname ] argtype [, ...] ] )− DROP FUNCTION name ( [ type [, ...] ] ) [ CASCADE | RESTRICT ]正文更新
PostgreSQL 7.4← 7.3正文更新

正文更新
PostgreSQL 7.3← 7.2语法变化

+ DROP FUNCTION name ( [ type [, ...] ] ) [ CASCADE | RESTRICT ]正文更新
PostgreSQL 7.2← 7.1正文更新

正文更新
PostgreSQL 7.1← 7.0文件改名

sql-dropfunction.htm → sql-dropfunction.html

正文更新
PostgreSQL 7.0← 6.5正文更新

正文更新

命令	动词	对象	最近变更
FUNCTIONS & PROCEDURES函数与过程18 条↑
`CALL`	CALL	—	—
调用一个过程			现存
`DO`	DO	—	—
执行匿名代码块			现存
`CREATE AGGREGATE`	CREATE	AGGREGATE	1911 次
定义一个新的聚合函数			现存
`ALTER AGGREGATE`	ALTER	AGGREGATE	147 次
更改一个聚合函数的定义			现存
`DROP AGGREGATE`	DROP	AGGREGATE	106 次
移除一个聚合函数			现存
`CREATE FUNCTION`	CREATE	FUNCTION	1416 次
定义一个新函数			现存
`ALTER FUNCTION`	ALTER	FUNCTION	1411 次
更改函数的定义			现存
`DROP FUNCTION`	DROP	FUNCTION	104 次
移除一个函数			现存
`CREATE LANGUAGE`	CREATE	LANGUAGE	137 次
定义一种新的过程语言			现存
`ALTER LANGUAGE`	ALTER	LANGUAGE	144 次
更改一种过程语言的定义			现存
`DROP LANGUAGE`	DROP	LANGUAGE	8.25 次
移除一种过程语言			现存
`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	101 次
定义一个新的转换			现存
`DROP TRANSFORM`	DROP	TRANSFORM	9.61 次
移除一个转换			现存